Re: Style question (and other things)

On Sun, Jun 21, 2009 at 21:33, Garrett W.<mail@garrettw.net> wrote: > I was considering attempting to join the doc team just now, mainly to work > on inconsistencies in style of writing or unprofessional wording, but > thankfully a message was posted yesterday by another person wishing to join, > so now I know how to go about it. > > In any case, before I get started on that, I have a question about something > I found at > http://php.net/manual/en/control-structures.switch.php > regarding the two Note blocks near the beginning of the page. > Is it proper (or conforming to a MoS) for a Note block to say "Note:" > followed by "Note that ..."? Seems a bit redundant. Couple of years ago we changed Docbook rendering application and styles. In the old one obscure rules dictated if the note would have a leading 'note:' or not, wheras in the new one it always says 'Note: ...'. So, there may be some cases where a note starts with 'Note: Note that..' :) What is "MoS" anyway? :) -Hannes