Skip to content

Documentation Roadmap

mikeorr edited this page Feb 10, 2012 · 9 revisions

This page discusses planned and potential revisions to the Pyramid documentation. (Updated: February 2012)

Reference

Recent changes

None yet.

In-progress and planned changes

The Pylons Project is raising $5000 to fund an overhaul of the manual. Graham Higgens will do the writing. Contact Chris McDonough if you can contribute some money. The general plan is to shrink the manual's size and make it more user-friendly. The most advanced-level content will be moved to another manual or documents.

Mike Orr is writing a "Pyramid for Pylons Users" guide for the Cookbook, and will restructure the Cookbook into topic-sections.

Potential changes

None yet.

How can I contribute?

If you have a short FAQ answer or a HOWTO, put it in the Cookbook. Fork the Cookbook on Github, make your changes, and submit a pull request. See the Contributing page re copyright and license. All Cookbook material will be considered for incorporation into the official docs at a later date, if it's sufficiently relevant and correct.

If you have an external article you'd like to incorporate into the Cookbook and you don't have time to do it now, or you have an idea for one but insufficient time or expertise to write it now, list it in the TODO section of the Cookbook.

If you have a hands-on tutorial (generally, a step-by-step guide for building an application), put it in the Pyramid Tutorials.

If you have a piece that's neither a HOWTO or a tutorial, for instance how your organization is using Pyramid, put it in the Cookbook somewhere (make a new section if none of the existing ones are appropriate). Or write up an external blog post and put a link to it in the Cookbook.

Other suggestions and comments

Users: what would you like to see in the Pyramid documentation? List short things here. For long things, create a separate wiki page and link it here.