1
Vote

Documentation (CHM) is incomplete

description

Is there an updated one? The .CHM in the latest drop is still really half-baked (pardon me for saying so, but it's true). It's full of "see <link>" placeholder text, broken links, and references to sections that do not exist.
 
I understand that poor/incomplete documentation is the bane of most open source projects, but -- especially in a project like this one -- documentation should be treated as a first-class citizen.

comments

blainew wrote Apr 13, 2010 at 9:52 PM

We are close to finishing the documentation. I would be interested in getting your feedback as to whether it is a first-class citizen at that time. Our process is to develop the code and then complete the documentation. So yes it will appear during the development that documentation is not first-class.

Blaine Wastell
Program Manager
patterns & practices.

GregWoods wrote May 28, 2010 at 8:57 AM

In the CHM, the ends of lines disappear under the (unnecessary) horizontal scrollbar making reading difficult.
It would also be nice if the text size in the CHM was adjustable (I'm sure I;ve seen this in some CHM files)

wrote Feb 21, 2013 at 11:02 PM