Thanks for the comments! I used the sectN because all other docs in the install\windows directory used it.
I will try the procedure element and use it if it works. By entities you mean """ - right? > -----Original Message----- > From: Hannes Magnusson [mailto:hannes.magnus...@gmail.com] > Sent: Wednesday, September 30, 2009 1:00 PM > To: Ruslan Yakushev > Cc: PHP Documentation ML > Subject: Re: Asking for feedback on the documentation update > > 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
