starting more docs

--HG--
branch : distribute
extra : rebase_source : 9826d4158ddc98c84e56d2c54445ad9efba77be4

1 files changed, 21 insertions, 0 deletions

diff --git a/docs/using.txt b/docs/using.txt
new file mode 100644
index 00000000..192f1dc2
--- /dev/null
+++ b/docs/using.txt
@@ -0,0 +1,21 @@
+================================
+Using Distribute in your project
+================================
+
+To use Distribute in your project, the recommended way is to ship
+`distribute_setup.py` alongside your `setup.py` script and call 
+it at the very begining of `setup.py` like this::
+
+    from distribute_setup import use_setuptools
+    use_setuptools()
+
+Another way is to add ``Distribute`` in the ``install_requires`` option::
+
+    from setuptools import setup
+
+    setup(...
+          install_requires=['distribute']
+    )
+
+
+XXX to be finished