this is a german Web-Mirror of PYTHON.ORG powered by Domainunion AG

Differences between revisions 1 and 13 (spanning 12 versions)
Revision 1 as of 2005-09-16 07:32:45
Size: 638
Editor: staselog
Comment: Stub
Revision 13 as of 2009-02-28 17:24:41
Size: 2190
Editor: PaulBoddie
Comment: Added homepage guidelines.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
(when there's no content, it's better to put ''something'' in and let others correct it, no?) = Wiki Editing Guidelines =
Line 5: Line 5:
 * Please structure long pages to sections (learn to use '== headings ==')
 * If you have source code included, run it yourself to test for at least simple errors
 * Avoid duplicating information when not necessary, and respect copyrights. If you are unsure,
   at least credit the source, so that others can fix things if needed
 * Learn to use WikiFormat => HelpOnFormatting. It allows for more consistent page styles
 * If you want to add a new page, check to see if there isn't already a page for that topic.
 * If you can't edit a page because you don't have permission, yet really need to change something, send a mail to <<MailTo(pydotorg AT python DOT org)>> mentioning the page and your motivations. We have locked down some pages of this Wiki which have proven to be continuing targets of vandals.
 * If you want to create your own "homepage" on the Wiki, please only do so if you're providing or promoting Python-related content or if you have signed your name on another page (and want others to be able to contact you). Please add your homepage to CategoryHomepage.
 * Please structure long pages to sections (learn to use '== headings ==').
 * If you have source code included, run it yourself to test for at least simple errors.
 * Avoid duplicating information when not necessary, and respect copyrights. If you are unsure, at least credit the source, so that others can fix things if needed.
 * Learn to use Wiki format mentioned in HelpOnFormatting. It allows for more consistent page styles.
 * You can use [[HelpOnParsers/ReStructuredText|ReStructured Text]] mark-up, but this can be confusing to people, so try not to do this too much. Importing content from somewhere else for initial publication is probably the most excusable exception. Pages requiring more sophisticated markup are also easier done with ReST than with !MoinMoin markup.
 * Take advantage of this Wiki's ability to format and colour Python source code - it is easier to read than a simple, plain monochrome section. An example:
 {{{
#!python
from hello import world
Line 11: Line 18:
Yeah, this is a stub only... def say_hello():
    """Just say hello :)"""
    what = world()
    message = what.greet() # no, there's no module named "hello"
                            # in Python stdlib - at least not yet :)
    return message

if __name__ == "__main__":
    say_hello()
}}}
 * When there's no content on a topic, it's better to put ''something'' in and let others correct it, don't you think? What are you waiting for?!

Wiki Editing Guidelines

Currently there are only few guidelines for creating a page inside Python Wiki:

  • If you want to add a new page, check to see if there isn't already a page for that topic.
  • If you can't edit a page because you don't have permission, yet really need to change something, send a mail to <pydotorg AT python DOT org> mentioning the page and your motivations. We have locked down some pages of this Wiki which have proven to be continuing targets of vandals.

  • If you want to create your own "homepage" on the Wiki, please only do so if you're providing or promoting Python-related content or if you have signed your name on another page (and want others to be able to contact you). Please add your homepage to CategoryHomepage.

  • Please structure long pages to sections (learn to use '== headings ==').
  • If you have source code included, run it yourself to test for at least simple errors.
  • Avoid duplicating information when not necessary, and respect copyrights. If you are unsure, at least credit the source, so that others can fix things if needed.
  • Learn to use Wiki format mentioned in HelpOnFormatting. It allows for more consistent page styles.

  • You can use ReStructured Text mark-up, but this can be confusing to people, so try not to do this too much. Importing content from somewhere else for initial publication is probably the most excusable exception. Pages requiring more sophisticated markup are also easier done with ReST than with MoinMoin markup.

  • Take advantage of this Wiki's ability to format and colour Python source code - it is easier to read than a simple, plain monochrome section. An example:
       1 from hello import world
       2 
       3 def say_hello():
       4     """Just say hello :)"""
       5     what = world()
       6     message = what.greet()  # no, there's no module named "hello" 
       7                             # in Python stdlib - at least not yet :)
       8     return message
       9 
      10 if __name__ == "__main__":
      11     say_hello()
    
  • When there's no content on a topic, it's better to put something in and let others correct it, don't you think? What are you waiting for?!

WikiGuidelines (last edited 2013-11-14 18:29:01 by PaulBoddie)

Unable to edit the page? See the FrontPage for instructions.