From 87ff89d12d109066ff355ed267787d32a6b5aeb7 Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Thu, 7 Jun 2012 11:32:28 -0500 Subject: [PATCH] Fixed #17933 -- Added intro note to writing-documentation.txt Based on initial patch by Thomas Westfeld --- .../contributing/writing-documentation.txt | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/internals/contributing/writing-documentation.txt b/docs/internals/contributing/writing-documentation.txt index c5a85764ba..e91d1291e9 100644 --- a/docs/internals/contributing/writing-documentation.txt +++ b/docs/internals/contributing/writing-documentation.txt @@ -18,6 +18,22 @@ Documentation changes generally come in two forms: This section explains how writers can craft their documentation changes in the most useful and least error-prone ways. +Getting the raw documentation +----------------------------- + +Though Django's documentation is intended to be read as HTML at +http://docs.djangoproject.com/, we edit it as a collection of text files for +maximum flexibility. These files live in the top-level ``docs/`` directory of a +Django release. + +If you'd like to start contributing to our docs, get the development version of +Django from the source code repository +(see :ref:`installing-development-version`). The development version has the +latest-and-greatest documentation, just as it has latest-and-greatest code. +Generally, we only revise documentation in the development version, as our +policy is to freeze documentation for existing releases (see +:ref:`differences-between-doc-versions`). + Getting started with Sphinx ---------------------------