Re: finding a style guide
| From: | Daniel Convissor | Date: | Tue, 06 Apr 2010 14:47:56 +0000 |
| Subject: | Re: finding a style guide | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969381559@lists.php.net to get a copy of this message | ||
Hi Philip:
> - http://fedoraproject.org/wiki/DocsProject/StyleGuide
Wow. That's an excellent read. Thanks. Though the a/an URL section
needs cleaning up, so I emailed them about it.
> - http://oreilly.com/oreilly/author/stylesheet.html
While I don't like the way this one is written, it does cover some
additional points, such as which DocBook elements to use in certain
situations and how to capitalize headings.
> Perhaps you have ideas and thoughts on the matter? I like the idea of
> others doing the work for us (updating their guide, us using it) but
> we'll also have a few of our own quirks and needs. Perhaps we should
> list our needs/differences, then link to our preferred guide?
Yeah, it is nice to use existing resources. Perhaps link to the Fedora
document and then cherry pick stuff from O'Reilly's to put in ours, along
with our own quirks?
Thanks,
--Dan
--
T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y
data intensive web and database programming
http://www.AnalysisAndSolutions.com/
4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409