summaryrefslogtreecommitdiff
path: root/docs/index.rst
diff options
context:
space:
mode:
authorLance Stout <lancestout@gmail.com>2011-08-12 17:33:32 -0700
committerLance Stout <lancestout@gmail.com>2011-08-12 17:33:32 -0700
commit5ef197e5fd93e851cb0da5a630fd38a191074371 (patch)
treeaa060bd25946e76f8e6d0bdce48d62f8f6da9dc5 /docs/index.rst
parent52ed02bd06f1762ef5f36e95f24ccb8230c1b36b (diff)
downloadslixmpp-5ef197e5fd93e851cb0da5a630fd38a191074371.tar.gz
slixmpp-5ef197e5fd93e851cb0da5a630fd38a191074371.tar.bz2
slixmpp-5ef197e5fd93e851cb0da5a630fd38a191074371.tar.xz
slixmpp-5ef197e5fd93e851cb0da5a630fd38a191074371.zip
Start of docs for 1.0
Diffstat (limited to 'docs/index.rst')
-rw-r--r--docs/index.rst130
1 files changed, 130 insertions, 0 deletions
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644
index 00000000..3b9e8298
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,130 @@
+SleekXMPP
+#########
+
+.. sidebar:: Get the Code
+
+ .. code-block:: sh
+
+ pip install sleekxmpp
+
+ The latest source code for SleekXMPP may be found on `Github
+ <http://github.com/fritzy/SleekXMPP>`_. Releases can be found in the
+ ``master`` branch, while the latest development version is in the
+ ``develop`` branch.
+
+ **Stable Releases**
+ - `1.0 Beta6.1 <http://github.com/fritzy/SleekXMPP/zipball/1.0-Beta6.1>`_
+ - `1.0 Beta5 <http://github.com/fritzy/SleekXMPP/zipball/1.0-Beta5>`_
+ - `1.0 Beta4 <http://github.com/fritzy/SleekXMPP/zipball/1.0-Beta4>`_
+ - `1.0 Beta3 <http://github.com/fritzy/SleekXMPP/zipball/1.0-Beta3>`_
+ - `1.0 Beta2 <http://github.com/fritzy/SleekXMPP/zipball/1.0-Beta2>`_
+ - `1.0 Beta1 <http://github.com/fritzy/SleekXMPP/zipball/1.0-Beta1>`_
+
+ **Develop Releases**
+ - `Latest Develop Version <http://github.com/fritzy/SleekXMPP/zipball/develop>`_
+ - `External Roster (Based on Develop Version) <http://github.com/fritzy/SleekXMPP/zipball/roster>`_
+
+
+ A mailing list and XMPP chat room are available for discussing and getting
+ help with SleekXMPP.
+
+ **Mailing List**
+ http://groups.google.com/group/sleekxmpp-discussion
+
+ **Chat**
+ `sleek@conference.jabber.org <xmpp:sleek@conference.jabber.org?join>`_
+
+
+SleekXMPP is an :ref:`MIT licensed <license>` XMPP library for Python 2.6/3.1+,
+and is featured in examples in
+`XMPP: The Definitive Guide <http://oreilly.com/catalog/9780596521271>`_
+by Kevin Smith, Remko Tronçon, and Peter Saint-Andre. If you've arrived
+here from reading the Definitive Guide, please see the notes on updating
+the examples to the latest version of SleekXMPP.
+
+SleekXMPP's design goals and philosphy are:
+
+**Low number of dependencies**
+ Installing and using SleekXMPP should be as simple as possible, without
+ having to deal with long dependency chains.
+
+ As part of reducing the number of dependencies, some third party
+ modules are included with SleekXMPP in the ``thirdparty`` directory.
+ Imports from this module first try to import an existing installed
+ version before loading the packaged version, when possible.
+
+**Every XEP as a plugin**
+ Following Python's "batteries included" approach, the goal is to
+ provide support for all currently active XEPs (final and draft). Since
+ adding XEP support is done through easy to create plugins, the hope is
+ to also provide a solid base for implementing and creating experimental
+ XEPs.
+
+**Rewarding to work with**
+ As much as possible, SleekXMPP should allow things to "just work" using
+ sensible defaults and appropriate abstractions. XML can be ugly to work
+ with, but it doesn't have to be that way.
+
+SleekXMPP Architecture and Design
+---------------------------------
+.. toctree::
+ :maxdepth: 2
+
+ architecture.rst
+
+Tutorials, FAQs, and How To Guides
+----------------------------------
+.. toctree::
+ :maxdepth: 2
+
+ quickstart
+ xmpp_tdg
+ create_plugin
+ guide_xep_0030
+
+
+API Reference
+-------------
+.. toctree::
+ :maxdepth: 2
+
+ event_index
+ api/clientxmpp
+
+Additional Info
+---------------
+.. toctree::
+ :hidden:
+
+ glossary
+ license
+
+* :ref:`license`
+* :ref:`glossary`
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+
+Credits
+-------
+**Main Author:** Nathan Fritz
+ `fritzy@netflint.net <xmpp:fritzy@netflint.net?message>`_,
+ `@fritzy <http://twitter.com/fritzy>`_
+
+ Nathan is also the author of XMPPHP and `Seesmic-AS3-XMPP
+ <http://code.google.com/p/seesmic-as3-xmpp/>`_, and a member of the XMPP
+ Council.
+
+**Co-Author:** Lance Stout
+ `lancestout@gmail.com <xmpp:lancestout@gmail.com?message>`_,
+ `@lancestout <http://twitter.com/lancestout>`_
+
+**Contributors:**
+ - Brian Beggs (`macdiesel <http://github.com/macdiesel>`_)
+ - Dann Martens (`dannmartens <http://github.com/dannmartens>`_)
+ - Florent Le Coz (`louiz <http://github.com/louiz>`_)
+ - Kevin Smith (`Kev <http://github.com/Kev>`_, http://kismith.co.uk)
+ - Remko Tronçon (`remko <http://github.com/remko>`_, http://el-tramo.be)
+ - Te-jé Rogers (`te-je <http://github.com/te-je>`_)
+ - Thom Nichols (`tomstrummer <http://github.com/tomstrummer>`_)
+