Please restyle your wiki - code unreadable

For general questions and discussions specific to the AbleCommerce GOLD ASP.Net shopping cart software.
Post Reply
User avatar
NC Software
AbleCommerce Partner
AbleCommerce Partner
Posts: 4620
Joined: Mon Sep 13, 2004 6:06 pm
Contact:

Please restyle your wiki - code unreadable

Post by NC Software » Sun Mar 23, 2014 1:26 pm

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
Neal Culiner
NC Software, Inc.

User avatar
Katie
AbleCommerce Admin
AbleCommerce Admin
Posts: 2651
Joined: Tue Dec 02, 2003 1:54 am
Contact:

Re: Please restyle your wiki - code unreadable

Post by Katie » Tue Mar 25, 2014 8:42 am

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.

Image

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.
Thank you for choosing AbleCommerce!

http://help.ablecommerce.com - product support
http://wiki.ablecommerce.com - developer support

User avatar
NC Software
AbleCommerce Partner
AbleCommerce Partner
Posts: 4620
Joined: Mon Sep 13, 2004 6:06 pm
Contact:

Re: Please restyle your wiki - code unreadable

Post by NC Software » Tue Mar 25, 2014 8:58 am

I'll just zoom in, there's very little content on the wiki anyway.
Entity.jpg
Neal Culiner
NC Software, Inc.

User avatar
Katie
AbleCommerce Admin
AbleCommerce Admin
Posts: 2651
Joined: Tue Dec 02, 2003 1:54 am
Contact:

Re: Please restyle your wiki - code unreadable

Post by Katie » Tue Mar 25, 2014 9:02 am

If you have suggestions on what additional content should be there, please let me know.
Thank you for choosing AbleCommerce!

http://help.ablecommerce.com - product support
http://wiki.ablecommerce.com - developer support

User avatar
NC Software
AbleCommerce Partner
AbleCommerce Partner
Posts: 4620
Joined: Mon Sep 13, 2004 6:06 pm
Contact:

Re: Please restyle your wiki - code unreadable

Post by NC Software » Tue Mar 25, 2014 9:09 am

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)
Neal Culiner
NC Software, Inc.

User avatar
NC Software
AbleCommerce Partner
AbleCommerce Partner
Posts: 4620
Joined: Mon Sep 13, 2004 6:06 pm
Contact:

Re: Please restyle your wiki - code unreadable

Post by NC Software » Tue Mar 25, 2014 9:22 am

Anyways, this was just about trying to get bigger fonts to be more readable...thx, will just zoom.
Neal Culiner
NC Software, Inc.

User avatar
NC Software
AbleCommerce Partner
AbleCommerce Partner
Posts: 4620
Joined: Mon Sep 13, 2004 6:06 pm
Contact:

Re: Please restyle your wiki - code unreadable

Post by NC Software » Tue Mar 25, 2014 2:24 pm

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.
Neal Culiner
NC Software, Inc.

Post Reply