p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Fixed #3933 -- Updated docs/documentation.txt to reflect the lack of comments on documentation. Thanks, Paul B. 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@4960 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2007-04-09 01:13:49 +00:00
parent 0e0a1dc0b7
commit 7693000788
1 changed files with 13 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docs/documentation.txt
View File

@ -42,25 +42,25 @@ On the Web
The most recent version of the Django documentation lives at The most recent version of the Django documentation lives at
http://www.djangoproject.com/documentation/ . These HTML pages are generated http://www.djangoproject.com/documentation/ . These HTML pages are generated
automatically from the text files in source control every 15 minutes. That automatically from the text files in source control. That means they reflect
means they reflect the "latest and greatest" in Django -- they include the very the "latest and greatest" in Django -- they include the very latest
latest corrections and additions, and they discuss the latest Django features, corrections and additions, and they discuss the latest Django features,
which may only be available to users of the Django development version. (See which may only be available to users of the Django development version. (See
"Differences between versions" below.) "Differences between versions" below.)
A key advantage of the Web-based documentation is the comment section at the We encourage you to help improve the docs by submitting changes, corrections
bottom of each document. This is an area for anybody to submit changes, and suggestions in the `ticket system`_. The Django developers actively monitor
corrections and suggestions about the given document. The Django developers the ticket system and use your feedback to improve the documentation for
frequently monitor the comments there and use them to improve the documentation everybody.
for everybody.
We encourage you to help improve the docs: it's easy! Note, however, that Note, however, that tickets should explicitly relate to the documentation,
comments should explicitly relate to the documentation, rather than asking rather than asking broad tech-support questions. If you need help with your
broad tech-support questions. If you need help with your particular Django particular Django setup, try the `django-users mailing list`_ or the
setup, try the `django-users mailing list`_ instead of posting a comment to the `#django IRC channel`_ instead.
documentation.
.. _ticket system: http://code.djangoproject.com/simpleticket?component=Documentation
.. _django-users mailing list: http://groups.google.com/group/django-users .. _django-users mailing list: http://groups.google.com/group/django-users
.. _#django IRC channel: irc://irc.freenode.net/django
In plain text In plain text
------------- -------------
@ -134,14 +134,6 @@ We follow this policy:
frozen document that says "These docs are frozen for Django version XXX" frozen document that says "These docs are frozen for Django version XXX"
and links to the current version of that document. and links to the current version of that document.
* Once a document is frozen for a Django release, we remove comments from
that page, in favor of having comments on the latest version of that
document. This is for the sake of maintainability and usability, so that
users have one, and only one, place to leave comments on a particular
document. We realize that some people may be stuck on a previous version
of Django, but we believe the usability problems with multiple versions
of a document the outweigh the benefits.
* The `main documentation Web page`_ includes links to documentation for * The `main documentation Web page`_ includes links to documentation for
all previous versions. all previous versions.