3 ms·

Are you seriously comparing docs in a different language to a colour scheme you dislike!? That is an utterly ridiculous comparison.

• saosebastiao 12y ago
  And yet the end effect is the same: I dont use the product. When you want people to learn your new new framework, complete with all the new idioms and terminology and workflows, the last thing you should burden your users with is bizarre asthetics. It makes it hard to scan docs, identify features, and focus their attention where you want it. You could take a barebones default wordpress blog and write your docs in that and it would be a reduced barrier to entry.
  • jallmann 12y ago
    The only "problem" is the cute color scheme (each Ocsigen projects gets its own scheme), but so what. Believe me, you don't notice the colors when using these docs for Real Work. The content here is solid; complaining about aesthetics from a quick skim is the equivalent of judging a book by its cover.