Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Loading…

The documentation is ugly #160

Closed
drozzy opened this Issue · 2 comments

3 participants

@drozzy

Sorry to say it like that, but reading documentation is not a pleasant experience.

I will use this page as an example: http://snapframework.com/docs/tutorials/snap-api

  1. The layout, with it's 3-triple spacing is hard to follow. E.g. see the defitions of functions "dir" and "ifTop" down the page - it is not clear what is the heading and what is a list item.
  2. Code examples on the dark background look out of place, and it's hard to switch context from white to black.
  3. The "code" font in the text is sometimes indistinguishable from regular text. E.g. the term "snap-core" looks very much like regular text, and so does "dir" and "ifTop" terms in their respective definitions.
  4. Some text is not marked as code. For example in the: "If the user requested /foo, then return "bar"." both "/foo" and "bar" should be typeset in code font.

In general, I think the CSS might benefit from using Bootstrap.

@gregorycollins

Fixed what I consider to be bugs here, rest of the complaints go to /dev/null (sorry, /dev/null). I'm likely to redesign the website when snap 1.0 comes out anyways.

BTW, in future: pull requests are less aggravating than gripe lists.

@mightybyte
Owner

You're clearly in the minority here.

http://news.ycombinator.com/item?id=1369852

Also, we launched snapframework.com before bootstrap existed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.