One of the issues with any documentation in an Open Source project is that often those writing the documentation are either too aware of the issues to explain them in a way to those who are completely new, or alternativly they have other demands on their (valuable) free time.
penguinaka Much of the Calibre manual is actually written by users. If you can think of improvements then I suggest you write them up with the suggested text and submit them as potential manual alterations to Kovid. I have done this myself a few times and Kovid has always incorporated my new text (albeit sometimes with minor editing) into te manual.
|