The b2evolution User Manual has been following a rocky path all these years.
Our latest attempt was to sort of crowdsource the Manual by using a Wiki platform to run it. This resulted in many tips & tricks pages, a lot of spam pages... and not a lot of core documentation.
Well, we are going to put the manual back in the hands of the developers. And out goes the Wiki, which is really not that convenient to use for editing anyways. This doesn't mean, though, that there is no space for user input. As a matter of fact, the new manual will be based on a b2evolution blog (which gives us 100% control on how we want to deal with spam) and each page will have a comments section.
We plan to run this a little bit like the PHP Manual... which has user comments... but they are heavily moderated and edited for clarity... so that the signal to noise ratio can stay as high as possible. (Unmoderated speach is available in the Forums).
One aspect where the PHP Manual falls a little short still... is the structured chapter navigation. Well it's not as bad as the Wiki which has no chapters and no structure at all, but still, it's a bit difficult to know exactly where you are in the PHP manual... you know approximatelty but you're never sure if you're at the last level or not.
So we are developing a "manual skin" inspired by the PHP manual but with a little bit more visual cues as to were we are.
There are 2 mockups attached to this post. One shows what happens when you are browsing through chapters & sub-chapters. The other shows what happens when you reached a manual page.
If you have thoughts about this, please send us your feedback below so we can adjust our target if need be.