On Wed, Sep 30, 2009 at 21:26, Ruslan Yakushev <rusl...@microsoft.com> wrote: > 1. The overall instruction style and wording
I haven't read the whole thing, but it looks great. I'm a bit unsure why you are using <sectN> rather then <section>, but I assume the rest of the install docs use those elements, so thats fine. > 2. The usage of examples and notes I wouldn't include the note on "after this the required steps are completed" in the example itself, I'd move it out of the <example> element. > 3. The usage of highlights > 4. Anything else that you think is important. + The extension is available for 32-bit and 64-bit platforms - select the right download package for your platform. Most people have no idea what that means, but IIRC it is explained somewhere on windows.php.net howto find it out so I guess its fine. You don't need to use entities for single and double quotes.. there is nothing wrong with it, but I don't think we do it anywhere else in the docs. Rather then using orderedlists and listitems, there are a set of elements in DocBook called procedure[1], step and substep.. To be honest, I'm not sure if PhD supports them perfectly, but its something to look into though. -Hannes [1] http://www.docbook.org/tdg5/en/html/procedure.html
