Hi Yorik, all,
I finished my review of the manual. Overall I have 138 comments. After the first indication by Yorik about how to provide comments (.. do as you wish
), I opted for comments in the exported pdf version, as this was more handy for me. I would have inserted comments directly in gitbooks, but it seems that discussions are enabled, but inline comments no (it is an option that must be explicitly enabled, see the FAQ
The file is too big to be attached to the post, you can find it at this link
(note: to properly see the comments, you cannot view the document online, you need to download it and open it locally).
I also did not want to modify directly the wiki, for two reasons:
1) I felt that, as this was an effort by Yorik to have a consistent manual, he should review the comments and decide whether to accept them or not. If we start messing up with the manual in a 'distributed' fashion, I'm afraid we could lose the guiding principle "to try to keep something like one line of thought"
2) Which is master here? If we modify the wiki, then the gitbook version is NOT automatically updated. I guess that the reverse may hold. We need Yorik's view here. Do we abandon gitbook, or we use it as master?
I hope my review is useful, but don't be misled by the number of comments I had, it is a very good work and a step ahead in filling up one of the most wanted feature by newcomers - a good documentation.