Differences between revisions 26 and 27
Revision 26 as of 2011-03-14 22:31:15
Size: 4802
Editor: PaulBoddie
Comment: Let's make the point better, then.
Revision 27 as of 2011-03-14 22:51:40
Size: 5394
Editor: PaulBoddie
Comment: Introduced sections and tried to explain why people shouldn't "force" WikiName page names.
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
Currently there are only few guidelines for creating a page inside Python Wiki: We have these guidelines to keep things relatively organised and easy to find. Generally, when there's no content on a topic, it's better to put ''something'' in and let others correct it, but make sure to check what other people have written first.

== Creating Pages ==
Line 6: Line 8:
 * Do not use contrived WikiName page names. Where the name of something (for example, JEdit) is not already a WikiName, do not add spurious capital letters or change the case of letters (for example, JEdIt) to make such a name. Instead just create a page and then use the [[HelpOnLinking|link syntax]] (for example, `[[JEdit]]`) to refer to the page.
 * If you see something that needs to be changed, but you don't have permission, send a mail to <<MailTo(pydotorg-www AT python DOT org)>>. You know, public wikies have to lock down some pages from time to time.
 * 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 use the HomepageTemplate when creating your homepage so that it belongs to CategoryHomepage.  Also, mention '''something''' about your relationship to Python on your homepage. Something like, "I maintain the !WhoSeeWhatsIt Python wrapper" or, "I offer Python consulting services" would be more than sufficient. If you are just a Python fanboy (or fangirl), something like, "Isn't Python the greatest language since C?" would also be fine. If all the moderators see is an email address your page is likely to be summarily deleted. We don't have time to spend searching for your name and/or email elsewhere on the Wiki or in the broader Python community.
 * By all means choose a WikiName as a page name. Most pages on this Wiki use this style.
 * ''
Do not'' change the names of things to "force" a WikiName. For example, JEdit is not a WikiName, but this does not mean that you should somehow make it one by changing letters and making, say, !JedIt. Instead just create a page and then use the [[HelpOnLinking|link syntax]] (for example, `[[JEdit]]`) to refer to the page.

== Editing Protected Pages ==

* If you see something that needs to be changed, but you don't have permission, send a mail to <<MailTo(pydotorg-www AT python DOT org)>>. You know, any Wiki editable by the general public unfortunately has to lock down some pages from time to time.

== Creating a Home Page ==

* 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 use the HomepageTemplate when creating your homepage so that it belongs to CategoryHomepage. (You will be prompted to do this when making a page.)
 * Try to
mention '''something''' about your relationship to Python on your homepage. Something like, "I maintain the !WhoSeeWhatsIt Python wrapper" or, "I offer Python consulting services" would be more than sufficient. If you are just a Python fanboy (or fangirl), something like, "Isn't Python the greatest language since C?" would also be fine. If all the moderators see is an email address your page is likely to be summarily deleted. We don't have time to spend searching for your name and/or email elsewhere on the Wiki or in the broader Python community.

== Writing Pages ==
Line 10: Line 24:
 * If you have source code included, run it yourself to test for at least simple errors.
Line 13: Line 26:
 * 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. Some features like category membership do not work for ReST pages, so consider converting ReST content to Wiki format at some point.
 * Do not upload attachments without referencing them in the page they are attached to (or in some other obviously connected page). Unclaimed attachments will be deleted!

== Tips ==
 * 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. Some features like category membership may not work for ReST pages, so consider converting ReST content to Wiki format at some point.
 * If you have source code included, run it yourself to test for at least simple errors.
Line 33: Line 43:
 * Use the `Issue:1234` syntax to refer to issues in the Python bug tracker. For example, here is an issue: Issue:7942.
 * 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?!

=== Linking ===

 * Although a WikiName will link to another page, don't be afraid of using the [[HelpOnLinking|link syntax]] to link to, say, the FrontPage by writing `[[FrontPage|front page]]` instead, thus producing a link to the [[FrontPage|front page]] like this.
 * Use the `Issue:7942` syntax to refer to issues in the Python bug tracker. For example, here is an issue: Issue:7942.

=== Attachments ===

 * Do not upload attachments without referencing them in the page they are attached to (or in some other obviously connected page). Unclaimed attachments will be deleted!

Wiki Editing Guidelines

We have these guidelines to keep things relatively organised and easy to find. Generally, when there's no content on a topic, it's better to put something in and let others correct it, but make sure to check what other people have written first.

Creating Pages

  • Before adding a new page, check if there isn't already a page for that topic.

  • By all means choose a WikiName as a page name. Most pages on this Wiki use this style.

  • Do not change the names of things to "force" a WikiName. For example, JEdit is not a WikiName, but this does not mean that you should somehow make it one by changing letters and making, say, JedIt. Instead just create a page and then use the link syntax (for example, [[JEdit]]) to refer to the page.

Editing Protected Pages

  • If you see something that needs to be changed, but you don't have permission, send a mail to <pydotorg-www AT python DOT org>. You know, any Wiki editable by the general public unfortunately has to lock down some pages from time to time.

Creating a Home Page

  • 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 use the HomepageTemplate when creating your homepage so that it belongs to CategoryHomepage. (You will be prompted to do this when making a page.)

  • Try to mention something about your relationship to Python on your homepage. Something like, "I maintain the WhoSeeWhatsIt Python wrapper" or, "I offer Python consulting services" would be more than sufficient. If you are just a Python fanboy (or fangirl), something like, "Isn't Python the greatest language since C?" would also be fine. If all the moderators see is an email address your page is likely to be summarily deleted. We don't have time to spend searching for your name and/or email elsewhere on the Wiki or in the broader Python community.

Writing Pages

  • Please structure long pages to sections (learn to use == headings ==).

  • 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. Some features like category membership may not work for ReST pages, so consider converting ReST content to Wiki format at some point.

  • If you have source code included, run it yourself to test for at least simple errors.
  • 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()
    

    Use numbers=disable after the language declaration (such as #!python) to remove line numbering.

Linking

  • Although a WikiName will link to another page, don't be afraid of using the link syntax to link to, say, the FrontPage by writing [[FrontPage|front page]] instead, thus producing a link to the front page like this.

  • Use the Issue:7942 syntax to refer to issues in the Python bug tracker. For example, here is an issue: 7942.

Attachments

  • Do not upload attachments without referencing them in the page they are attached to (or in some other obviously connected page). Unclaimed attachments will be deleted!

Etiquette

When editing existing pages, the following guidelines are proposed:

  • By all means make edits to pages in order to fix mistakes, update and add information, and so on.
  • Consider creating an account so that your contributions are acknowledged.
  • Use the preview button before committing.
  • When editing pages, particularly larger ones, try and commit all changes at once, or at least as many as possible at the same time. Don't make lots of small changes, saving each one: this fills the page history with micro-edits which make it very difficult to see earlier history information.
  • Remember that some pages have been around for a long time, are actively maintained, and are the result of collaboration between a number of people. It is therefore quite impolite to go in and to spontaneously reorganise such pages or to decide that your own editorial preferences overrule those of the people who have worked hard to produce the information you want to change, remove or rearrange. Consider contacting one or more of the maintainers before seeking to "refactor" content.
  • Respect any editorial guidelines on the pages you wish to edit. Do not remove guidelines you do not agree with!


CategoryPythonWebsite

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

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