X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=dakweb%2F__init__.py;h=c01bfc5755966c0c682e933f61b854374754eed7;hb=80108bebf0307acfc27d586e6faffe193199b14b;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hpb=a1cbf44860dcdae29b92a827e43f14d5ee5bd1e6;p=dak.git

diff --git a/dakweb/__init__.py b/dakweb/__init__.py
index e69de29b..c01bfc57 100644
--- a/dakweb/__init__.py
+++ b/dakweb/__init__.py
@@ -0,0 +1,41 @@
+"""
+General
+=======
+  The Debian Archive Kit web api, AKA the B{FTP-Master api}, allows
+  anyone to query the database of the Debian archive kit for information
+  related to the archive. That is, it provides information about the
+  archive, its suites and all the packages.
+
+  Development
+  -----------
+  B{NOTE}: B{The api} is still new and we are adding new features
+  whenever someone asks for them. Or better yet, provides a patch.
+  B{The api}s code lives in the C{dak} codebase, if you want to provide
+  a patch with a new feature, or fix a bug, feel free to clone it::
+   git clone https://ftp-master.debian.org/git/dak.git
+
+  Patches, Feature requests, bug reports go to the
+  U{debian-dak<mailto:debian-dak@lists.debian.org>}
+  mailing list.
+
+Usage
+=====
+  B{The api} responds to simple http queries and (usually) replies with
+  JSON formatted data. Some commands may require an extra parameter to
+  output JSON (notably the madison one).
+
+  U{https://api.ftp-master.debian.org/} is the base path for all
+  requests.
+
+  Available Methods
+  -----------------
+  The list of available methods can be seen by browsing the
+  automatically generated documentation for the L{dakweb.queries}
+  module. There are various submodules dealing with different parts of
+  the api. Every I{public} function of those modules corresponds to
+  one available method. The input parameters and the output format are
+  documented with each of those functions.
+
+
+@contact: "Debian FTPMaster <ftpmaster@debian.org>".
+"""