Mining the Wiki
We're at the book and documentation sprint out at the very lovely Woolman Centre near Nevada city in California. A sub group of us have taken on the mighty task of analysing how the wiki content sits with the book content. We're focusing on the User and Administrator guide at the moment, which is online at http://book.civicrm.org/user/.
What we're doing, is each taking a section of the book at a time, then going through the wiki - http://wiki.civicrm.org/confluence/display/CRMDOC and finding all related content.
We're then labelling the wiki pages in 2 ways:
1. According to which section of the book the page corresponds to e.g. 'basic-set-up' or 'events'.
2. An indication of the relationship between the wiki page and the book. One of the following 4 labels:
Legacy - Content which may be outdated, or perhaps doesn't seem that useful or relevent.
Included - Content which is already included comprhensivley in the book.
Intended - Content which is not included in the book and that we think it would be useful to include.
Additional - Content where some of it has been included, but we think that it would be beneficial to include other parts of that page.
Remaining - Content where it is appropriate for it to remain on the wiki
We think that with the combination of the chapter tag and the status tag, this is a really good start to mapping the relationship between the book and the wiki. This feels like stage 1 - getting a handle on the terrain. Stage 2 will happen at some point, which will be adding the relevant bits to the book, and using useful wiki content to edit existing parts of the book.
If you have any ideas that you think would be useful for us, we're working on this over the next few days. Also, if you want to get involved (virtually) just comment here and we can liase on section assignment so we don't tread one each others toes.
I'll give an update later on in the week.