Hi devs,

While thinking about what features a Technical Documentation Flavor [1]
should have, I came up with some ideas that we could integrate inside
xwiki.org in order to make it a better documentation website:
- navigation tree in the left panel, see
  --
http://design.xwiki.org/xwiki/bin/download/Proposal/Flavors/TechnicalDocumentationFlavor/ExampleXWiki/WebHome/xwiki_doc_partial.png
  compared to
  -- http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation
- simpler skin (at least remove the comments area - lots of deprecated
questions/answers and we have now the forum for that)
- simpler menu (less entries + merge with the navbar if technical possible
now, otherwise wait for newer version)
- simpler footer area by removing the number of links displayed (we need to
look at mouseflow)

Would be great also to upgrade XWiki.org to a newer version.

There were all sorts of ideas in the past like:
- displaying 'Edit' also for unregistered in order to encourage edits
- display 'Register'/'Log-in' links in the navbar in order to encourage
edits
these are not part of the current proposal, but keep the ideas coming :) we
will try to implement them when we can.

Of course it would be great if we would had time to:
- update the docs content
- reorganize pages
- update the blog styling
- etc.
but I guess small changes will come in time.

Let me know what you think,
Caty

[1]
http://design.xwiki.org/xwiki/bin/view/Proposal/Flavors/TechnicalDocumentationFlavor/

Reply via email to