piwik/developer-documentation — pull request #43 by mnapoli (2014-11-25 22:47:20+00:00)
Title: [WIP] Reorganization and redesign

**DO NOT MERGE YET**

Fixes #35, #40, #41, #42

Relates to #22

TODO:

- [ ] Write introduction guides for categories and subcategories
- [ ] Maybe reorganize some guides in "Develop" to make the left menu clearer

I've reorganized the sections/menu as discussed in #35:

- Home
- Integrate
- Develop (now contains guides for plugins + how piwik works/contributing)
- API reference
- Changelog
- Support

I've hidden "Design" for now (which contains guides for theming) per @mattab's request: the documentation is not good enough.

I've simplified the UI/templates/codebase, we now have:

- the home page
- guides

There is no "category home page" anymore. The idea is to do something like [Wordpress' developer documentation](https://developer.wordpress.org/plugins/): the category home page is actually a guide that introduces the category. The left menu should do the rest (see just below).

Navigation through the category is now done with the left menu which is always visible and which is focused mainly on listing **all guides of the category** (previously it listed by default the sections of the current guide: that is now below).

Navigating through a long guide is **less** practical with this design, but this is OK: we want to write smaller guides (like on Wordpress). Smaller guides are easier to read, easier to write and maintain. And by listing smaller guides hierarchically (like Wordpress again) makes the whole thing much easier for visitors.

I've splitted the MVC guide for example into (see the screenshot):

- MVC guide introduction
- How Piwik handles HTTP requests
- Models (APIs)
- Views
- Controllers

This is much easier to navigate and read for visitors (at least we think so), so we should try to do the same with other guides.

I've also improved (hopefully) the website design. Screenshots:

![home](https://cloud.githubusercontent.com/assets/720328/5193021/7e9bcff4-7561-11e4-9a88-e690e317dd7b.png)

![guide](https://cloud.githubusercontent.com/assets/720328/5193025/881c3672-7561-11e4-9b52-b3e5a8e7daee.png)