New documentation layout and updating process (and a leak)

2009-03-05 14:05
Written by
Together with releasing beta 4 of CiviCRM, we introduced first version of new documentation layout. It's been a while since our docs came through major overhaul and it was high time to start doing something about this. Main changes are in the top-level organization of sections and the documentation appearance - it has been tweaked to look a bit nicer and more consistent. This is still undergoing effort, so it will probably still take some time until all the pages have been reviewed and changed, but what we have there now looks like a good beginning. All remarks and suggestions are most welcome - preferred place to publish them is documentation board on the forum. We are also introducing a significant change in the way how documentation updating process will be handled. From now on, we will have separate documentation for each major version of CiviCRM (2.2, 2.3, etc). Long term goal for introducing this procedure is to make our docs simpler, relevant to only one version (right now the documentation refers to multiple versions, which introduces some confusion), also easier to maintain. Hopefully, the next step will be introducing regular review process that will help us assure that the docs are clean and up to date. How does it look like in practice? At the moment, there are three versions of documentation available: