Update:Remora Standards: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(added html, css and js standards)
m (added fullstop)
Line 16: Line 16:


= HTML =
= HTML =
HTML 4.01 Strict
HTML 4.01 Strict. Close and nest your tags correctly, as if you were writing XHTML.
Close and nest your tags correctly, as if you were writing XHTML.


= CSS =  
= CSS =  

Revision as of 22:00, 14 September 2006

« Back to Update:Remora

Style

Follow the PEAR Coding Standards with one exception:

No new line at EOF

Leaving a new line at the end of a .php file after the ?> will make horrible things happen for HTTP headers. Do not follow this standard.

Comments and PHPDoc

  • Read and understand the PHPDoc reference when needed.
  • Make a concerted effort to [write out comments], especially before function definitions. Bare minimum comments for function defs:
    • What it is for
    • @param - define all inputs and their type/purpose
    • @return - define all retvals and their type/purpose
  • // style comments can be used for smaller statements, just footnotes. If the footnote turns into an essay, use /** */

HTML

HTML 4.01 Strict. Close and nest your tags correctly, as if you were writing XHTML.

CSS

Valid

JavaScript

No errors with javascript.options.strict set to true

Testing