Difference between revisions of "RPi Wiki Best Practice"

From eLinux.org
Jump to: navigation, search
(Think of others)
Line 14: Line 14:
 
=Think of others=
 
=Think of others=
  
Goes hand in hand with Tip # 2. DO NOT BREAK LINKS.  See [[Help:Moving_a_page]] and [[Help:Deleting_a_page]].
+
Goes hand in hand with Tip # 2. DO NOT BREAK LINKS.  See [[Help:Moving_a_page]] and [[Help:Deleting_a_page]].
When the wiki gets more and more imortant over the time , we should avoid breaking older (and older) links.
+
When the wiki gets more and more imortant over the time , we should avoid breaking old (and older) links.
If you are unsure wheter  your goal cannot achieved otherwise (logical link loop) , discuss with others first.
+
If you are unsure wheter  your goal cannot achieved otherwise (logical link loop) , discuss with others first.
  
 
=Use templates=
 
=Use templates=

Revision as of 08:35, 18 March 2012


Keep basic structure

  • add [[Category:RaspberryPi]] to each of your articles and uploads
  • put this at the end of your page :
=References= 

Looks better ;-)

make it safe

make it clear to which audience the current page is aimed at , as seen here RPi Advanced Setup

Keep the beginners in mind.

Think of others

Goes hand in hand with Tip # 2. DO NOT BREAK LINKS. See Help:Moving_a_page and Help:Deleting_a_page. When the wiki gets more and more imortant over the time , we should avoid breaking old (and older) links. If you are unsure wheter your goal cannot achieved otherwise (logical link loop) , discuss with others first.

Use templates

Use the templates

  • {{Template:Raspberry Pi}} for the main pages
  • {{Template:RPi_Startup}} very important pages

Do not arbitarily extend and change them. They are specificially made for a better (BASIC) overview. Use Categories instead (Tip #1).

Keep it modular

If you see big lists and code listing cropping up , create a new article for them .

Bad Example : RPi Buying Guide had all the information now moved to RPi Buying Links By Country within a single page.

Please use the preview and see what monster you have created.

References