Difference between revisions of "One Earth Pattern style guide"

From Green Garage Detroit
Jump to: navigation, search
Line 3: Line 3:
 
** test your title by doing a 'google search'  using those keywords.  Check to see if what comes up is highly related to what you what to document.  If it is not then keep adjusting your keywords.  
 
** test your title by doing a 'google search'  using those keywords.  Check to see if what comes up is highly related to what you what to document.  If it is not then keep adjusting your keywords.  
 
** also see what wikipedia calls it.  This is, also, a global consensus.
 
** also see what wikipedia calls it.  This is, also, a global consensus.
* '''writing style examples'''
+
* '''Style'''
 
** A Pattern Language by Christopher Alexander
 
** A Pattern Language by Christopher Alexander
 
** Build it Solar ...really like the simple, helpful and uncomplicated style of Chris' writing.  He's provided a huge service to the solar movement.
 
** Build it Solar ...really like the simple, helpful and uncomplicated style of Chris' writing.  He's provided a huge service to the solar movement.
 
** [[Green Alley - Sustainable Design Features]]... brief descriptions of the Sustainable Elements of the Green Alley.
 
** [[Green Alley - Sustainable Design Features]]... brief descriptions of the Sustainable Elements of the Green Alley.
 +
* '''Media conventions'''
 +
** Images
 +
*** Put all pictures in GG Flickr account. Please tag them: Green Garage, sustainability, green, Detroit, ??? 
 +
*** May also need to upload them to the wiki if you need to size them in a special way. Try to minimize this.
 +
*** Help on how to insert flickr images in the GG wiki can be found here.
 +
** Videos
 +
*** Put all videos in GG YouTube account.  Please tag them: Green Garage, sustainability, green, Detroit, ??? 
 +
*** Help on how to insert YouTube videos in the GG wiki can be found here.
 +
* '''Categories'''
 +
** Every page should be placed in the Site index by placing... at the bottom of the page
 +
** A page may be part of another index...if so please place this category at the bottom of the page also.
 +
** Help of Categories can be found here.

Revision as of 13:49, 25 May 2009

  • Pattern Title (i.e page naming convention)
    • use the words that people would most commonly search the web to find it
    • test your title by doing a 'google search' using those keywords. Check to see if what comes up is highly related to what you what to document. If it is not then keep adjusting your keywords.
    • also see what wikipedia calls it. This is, also, a global consensus.
  • Style
    • A Pattern Language by Christopher Alexander
    • Build it Solar ...really like the simple, helpful and uncomplicated style of Chris' writing. He's provided a huge service to the solar movement.
    • Green Alley - Sustainable Design Features... brief descriptions of the Sustainable Elements of the Green Alley.
  • Media conventions
    • Images
      • Put all pictures in GG Flickr account. Please tag them: Green Garage, sustainability, green, Detroit, ???
      • May also need to upload them to the wiki if you need to size them in a special way. Try to minimize this.
      • Help on how to insert flickr images in the GG wiki can be found here.
    • Videos
      • Put all videos in GG YouTube account. Please tag them: Green Garage, sustainability, green, Detroit, ???
      • Help on how to insert YouTube videos in the GG wiki can be found here.
  • Categories
    • Every page should be placed in the Site index by placing... at the bottom of the page
    • A page may be part of another index...if so please place this category at the bottom of the page also.
    • Help of Categories can be found here.