Page 1 of 1
Please restyle your wiki - code unreadable
Posted: Sun Mar 23, 2014 1:26 pm
by NC Software
Hello,
On pages like
http://wiki.ablecommerce.com/index.php/ ... _-_AC_Gold the code sections are barely readable. I'm using a high res 27" monitor (25xx by 16xx) and I can't read the info on the screen on this site only. If you can look at better fonts/sizes that would help make those much more readable.
Thx
Re: Please restyle your wiki - code unreadable
Posted: Tue Mar 25, 2014 8:42 am
by Katie
I have the same size monitor, but my resolution isn't set to the very highest level (only 1920x1200). I checked in both Firefox and IE. Looks completely normal to me.
I don't want to change something that's been this way for a long time until we can figure out why it doesn't render properly for you.
Re: Please restyle your wiki - code unreadable
Posted: Tue Mar 25, 2014 8:58 am
by NC Software
I'll just zoom in, there's very little content on the wiki anyway.
Entity.jpg
Re: Please restyle your wiki - code unreadable
Posted: Tue Mar 25, 2014 9:02 am
by Katie
If you have suggestions on what additional content should be there, please let me know.
Re: Please restyle your wiki - code unreadable
Posted: Tue Mar 25, 2014 9:09 am
by NC Software
Between the wiki and the documentation there is very little. There should and could be a lot. The documentation simply is a collection of screenshots with brief caption of what something does which is of little value in my opinion. Use cases and examples would help with more detailed outlining of the uses. I went through the wiki, the concepts of building themes was brief and again of little value 1) take an existing theme and modify it or 2) build something from a PSD mockup.
Documentation is a huge job and in some companies requires a technical writer. You have the square filled that you "have documentation" but it's of little value. It is really about if you want to invest the time and effort to really describe and show examples of use. Before I go to something new I review all of the resources as I did with the docs and wiki, I was surprised not to find more in the wiki. I'm sure there have been a lot of helpful cases in the forums regarding GOLD which could have been lifted to the Wiki for a more permanent reference.
Just my $.02 - it's not fun work and it's hard work and it takes a lot of time and dedication to be of good use. Again, I suggest Confluence and also review Atlassian's docs for great examples and what I expect such as:
https://confluence.atlassian.com/displa ... ation+Home
and
https://documentation.red-gate.com/ (another use of confluence and also great documentation)
Re: Please restyle your wiki - code unreadable
Posted: Tue Mar 25, 2014 9:22 am
by NC Software
Anyways, this was just about trying to get bigger fonts to be more readable...thx, will just zoom.
Re: Please restyle your wiki - code unreadable
Posted: Tue Mar 25, 2014 2:24 pm
by NC Software
The documentation simply is a collection of screenshots with brief caption of what something does which is of little value in my opinion.
I retract this statement. After looking more into some of the documentation there is more helpful information than I first saw that will help non-experienced AC users.