[tor-commits] [stem/master] Raising FAQ category types
atagar at torproject.org
atagar at torproject.org
Tue Apr 16 03:41:35 UTC 2013
commit f5aacc8bff0056748e8bc16e15f98d13e4dad024
Author: Damian Johnson <atagar at torproject.org>
Date: Mon Apr 15 20:30:14 2013 -0700
Raising FAQ category types
Changing the category types so...
'subcategories' => 'categories'
'subsubcategories' => 'subcategories'
This better emphasizes the questions and gives them a slight horizontal ruler.
I'd like to get a more emphasized divider to better split up the questions but
the only way I know of to do that is a table, which would be gross.
---
docs/faq.rst | 22 +++++++++++-----------
1 files changed, 11 insertions(+), 11 deletions(-)
diff --git a/docs/faq.rst b/docs/faq.rst
index 43edba8..568e8e6 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -17,12 +17,12 @@ Frequently Asked Questions
* :ref:`what_is_the_copyright_for_patches`
Usage
------
+=====
.. _what_is_stem:
What is stem?
-^^^^^^^^^^^^^
+-------------
Stem is a python controller library that you can use to interact with `tor <https://www.torproject.org/>`_. With it you can write scripts and applications with capabilities similar to `Vidalia <https://www.torproject.org/getinvolved/volunteer.html.en#project-vidalia>`_ and `arm <http://www.atagar.com/arm/>`_.
@@ -31,7 +31,7 @@ From a technical standpoint, stem is a python implementation of Tor's `directory
.. _does_stem_have_any_dependencies:
Does stem have any dependencies?
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------------
**No.** All you need in order to use stem is python.
@@ -40,31 +40,31 @@ When it is available stem will use `pycrypto <https://www.dlitz.net/software/pyc
.. _what_python_versions_is_stem_compatible_with:
What python versions is stem compatible with?
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+---------------------------------------------
Stem works with **python 2.6 and greater**. This includes the python 3.x series by installing stem via python3 (see our `installation instructions <https://pypi.python.org/pypi/stem/>`_ for more information).
.. _what_license_is_stem_under:
What license is stem under?
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+---------------------------
Stem is under the `LGPLv3 <https://www.gnu.org/licenses/lgpl>`_.
.. _where_can_i_get_help:
Where can I get help?
-^^^^^^^^^^^^^^^^^^^^^
+---------------------
Do you have a tor related question or project that you would like to discuss? If so then find us on the `tor-dev@ email list <https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-dev>`_ and `IRC <https://www.torproject.org/about/contact.html.en#irc>`_.
Development
------------
+===========
.. _how_do_i_get_started:
How do I get started?
-^^^^^^^^^^^^^^^^^^^^^
+---------------------
The best way of getting involved with any project is to jump right in! Our `bug tracker <https://trac.torproject.org/projects/tor/wiki/doc/stem/bugs>`_ lists several development tasks. In particular look for the 'easy' keyword when getting started.
@@ -90,7 +90,7 @@ To start hacking on stem please do the following and don't hesitate to let me kn
.. _how_do_i_run_the_tests:
How do I run the tests?
-^^^^^^^^^^^^^^^^^^^^^^^
+-----------------------
Stem has three kinds of tests: **unit**, **integration**, and **static**.
@@ -126,7 +126,7 @@ See ``run_tests.py --help`` for more usage information.
.. _how_do_i_build_the_site:
How do I build the site?
-^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------
If you have `sphinx <http://sphinx-doc.org/>`_ version 1.1 or later installed then building our site is as easy as...
@@ -144,7 +144,7 @@ When it's finished you can direct your browser to the *_build* directory with a
.. _what_is_the_copyright_for_patches:
What is the copyright for patches?
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------------
Stem is under the LGPLv3 which is a fine license, but poses a bit of a problem for sharing code with our other projects (which are mostly BSD). To share code without needing to hunt down prior contributors we need an individual to have the copyright for the whole stem codebase. This is Damian at present, but I'll probably give it to Tor if I get nailed by a bus.
More information about the tor-commits
mailing list