Differences between revisions 3 and 4
Revision 3 as of 2009-12-09 09:53:32
Size: 1345
Editor: techtonik
Comment: python web site category
Revision 4 as of 2010-04-29 22:30:51
Size: 1355
Editor: PaulBoddie
Comment: Changed mailing list.
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
== Menu structure and URLs == == Menu Structure and URLs ==
Line 5: Line 5:
The site's url structure matches its menu structure, as displayed on the left hand side. As such, it's important to place new content appropriately and carefully limit what is added at the top level. There is a sweet spot between cluttering up the top level and nesting content The site's URL structure matches its menu structure, as displayed on the left hand side. As such, it's important to place new content appropriately and carefully limit what is added at the top level. There is a sweet spot between cluttering up the top level and nesting content
Line 8: Line 8:
URLs and file names should be all lower case and reasonably short without being hard to remember or becoming quirky or unusual abbreviations. For example, use 'doc' instead of 'documentation'.
URLs should look good and be manageable when pasted into an email or other document.
URLs and file names should be all lower case and reasonably short without being hard to remember or becoming quirky or unusual abbreviations. For example, use 'doc' instead of 'documentation'. URLs should look good and be manageable when pasted into an email or other document.
Line 17: Line 16:
Please seek peer review for major content changes, when adding to the overall menu structure, or when making significant changes to the home page. This can be done on the pydotorg mailing list: Please seek peer review for major content changes, when adding to the overall menu structure, or when making significant changes to the home page. This can be done on the [[http://mail.python.org/mailman/listinfo/pydotorg-www|pydotorg-www mailing list]].
Line 19: Line 18:
http://mail.python.org/mailman/listinfo/pydotorg

This is a start at writing down some of the conventions we've adopted for the python.org website. Please help by adding to it as you run into things that should be listed here:

The site's URL structure matches its menu structure, as displayed on the left hand side. As such, it's important to place new content appropriately and carefully limit what is added at the top level. There is a sweet spot between cluttering up the top level and nesting content overly deep that we are trying to cultivate.

URLs and file names should be all lower case and reasonably short without being hard to remember or becoming quirky or unusual abbreviations. For example, use 'doc' instead of 'documentation'. URLs should look good and be manageable when pasted into an email or other document.

Checking in Changes

Always test your changes before checking them in. The live site is automatically updated with new changes and will break in the same way that your local copy breaks if you check in typos.

Peer Review

Please seek peer review for major content changes, when adding to the overall menu structure, or when making significant changes to the home page. This can be done on the pydotorg-www mailing list.


CategoryPythonWebsite

PythonWebsite/Conventions (last edited 2010-04-29 22:30:51 by PaulBoddie)

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