diff options
| author | Kenneth Reitz <me@kennethreitz.com> | 2010-10-10 02:32:41 -0400 |
|---|---|---|
| committer | Kenneth Reitz <me@kennethreitz.com> | 2010-10-10 02:32:41 -0400 |
| commit | bc82be09c567871370eca21d5bf4aab73d87b350 (patch) | |
| tree | 5063599cb1a8bec8dd4b11bf37a2edf4b6d9a344 /docs/intro.rst | |
| parent | ed9fe01604b9ddc9c2156ae4f2d7e3813bb11f6a (diff) | |
| download | tablib-bc82be09c567871370eca21d5bf4aab73d87b350.tar.gz | |
Big Documentation Upgrade.
Diffstat (limited to 'docs/intro.rst')
| -rw-r--r-- | docs/intro.rst | 53 |
1 files changed, 44 insertions, 9 deletions
diff --git a/docs/intro.rst b/docs/intro.rst index b9c5f78..eab26cc 100644 --- a/docs/intro.rst +++ b/docs/intro.rst @@ -3,25 +3,43 @@ Introduction ============ -This part of the documentation covers all the interfaces of Tablib. For -parts where Tablib depends on external libraries, we document the most -important right here and provide links to the canonical documentation. +This part of the documentation covers all the interfaces of Tablib. +Tablib is a format-agnostic tabular dataset library, written in Python. It allows you to Pythonically import, export, and manipulate tabular data sets. -Why Tablib? ------------ +Inception +--------- -Why not? +Tablib was build by `Kenneth Reitz`_ to fufill a specfic need. -It Should Be Easy ------------------ +Tablib was born. + +.. _`Kenneth Reitz`: http://kennethreitz.com + + +Philosphy +--------- + +Tablib was developed with a few :pep:`20` idioms in mind. + + +#. Beautiful is better than ugly. +#. Explicit is better than implicit. +#. Simple is better than complex. +#. Complex is better than complicated. +#. Readability counts. + +Besides, Why not? + +:ref:`seperators` .. _mit: + MIT License ----------- -A large number of open source projects you find today are `GPL Licensed`_. While the GPL certianly has essential applications, it should most certianly not be your go-to license for you next open source project. +A large number of open source projects you find today are `GPL Licensed`_. While the GPL certianly has essential applications, it should most certianly not be your go-to license for your next open source project. A project that was released as GPL cannot be usd in any commercial product without the product itself also being offered as open source. The MIT and BSD licenses are fantastic alternatives to this *major* problem. @@ -30,4 +48,21 @@ Tablib is released under terms of `The MIT License`_. .. _`GPL Licensed`: http://www.opensource.org/licenses/gpl-license.php .. _`The MIT License`: http://www.opensource.org/licenses/mit-license.php + + +.. _pythonsupport: + +Pythons Supported +----------------- + +At this time, the following Python platforms are officially supported: + +* Python 2.6 +* Python 2.7 + +Support for other Pythons will be rolled out soon. + + + + Now, go :ref:`Install Tablib <install>`.
\ No newline at end of file |