Steve Piercy
2013-08-05 38d1dd411e1655d1fbc1bd8a5d5f36b0b1c43308
Merge pull request #1063 from stevepiercy/docs.gettingstarted

Adding my stab at a "getting started" with Pyramid
1 files added
84 ■■■■■ changed files
docs/getting_started/gettingstarted.rst 84 ●●●●● patch | view | raw | blame | history
docs/getting_started/gettingstarted.rst
New file
@@ -0,0 +1,84 @@
===============
Getting Started
===============
What is Pyramid?
----------------
Pyramid is a web application development framework.  Pyramid is lean, fast,
stable, well-tested, and thoroughly documented.  Pyramid is written in Python,
and is open source software released under a `BSD-like license
<http://repoze.org/license.html>`_.
Pyramid helps you "start small, finish big".  You can create a simple web
application using Pyramid with only basic knowledge.  As you become more
familiar with Pyramid, you'll find there is plenty of room to grow.  Code you
started with early on can be re-used in mature, large, powerful applications.
Pyramid has dozens of features — URL generation, authentication and
authorization, [one or two more?] — just like any other web application
framework.  Several features are unique and make Pyramid stand out from the
crowd.
* Traversal
* Python 3 compatibility
* Tweens
* Debug Toolbar
Installation Guide
------------------
The Installation Guide describes how to install everything needed to get
started with Pyramid.  It also offers practical advice on working with
projects.  Whether you're new to Pyramid, Python, programming, or web
application development, the Installation Guide will help you get your first
Pyramid application up and running and deployed into production.
Developer Guide
---------------
The Developer Guide describes Pyramid in depth.  Formerly called "narrative
documentation", the Developer Guide uses technical terms more familiar to the
seasoned web application developer.  Beginners may be challenged, to put it
mildly, but it's a challenge worth accepting.  Developers who have already
installed Pyramid, worked through a few tutorials, and are ready to write their
own applications will find that this guide offers a comprehensive understanding
of Pyramid.
API Guide
---------
The API Guide is a comprehensive reference for every public application
programming interface (API) exposed by Pyramid.  The API Guide lists each item,
its arguments, definition, narrative description, its inner workings, and the
values and objects it returns in great detail.
Tutorials and Screencasts
-------------------------
There are several tutorials and screencasts that give beginners and new-comers
to Pyramid hands-on experience with writing Pyramid applications.
http://docs.pylonsproject.org/projects/pyramid_tutorials/en/latest/
Add-ons
-------
Pyramid is extensible through add-ons.
http://docs.pylonsproject.org/en/latest/docs/pyramid.html#pyramid-add-on-documentation
Support
-------
https://github.com/Pylons/pylonsrtd/blob/master/index.rst#support
Pylons-discuss Google group/mail list
'#pyramid' IRC channel on irc.freenode.net
issue tracker on GitHub http://github.com/Pylons/pyramid/issues
Contributing
------------
Guidelines for contributing to Pyramid are available at the following URL.
https://github.com/Pylons/pylonsrtd/tree/master/community
Community
---------
http://docs.pylonsproject.org/projects/pyramid_cookbook/en/latest/