mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-10-31 20:09:34 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
27545 commits 30 branches 460 tags 721 MiB
Commit graph

47 commits

Author SHA1 Message Date
Tobias Kunze
4a954cfd11 Fixed #30573 -- Rephrased documentation to avoid words that minimise the involved difficulty. 
This patch does not remove all occurrences of the words in question.
Rather, I went through all of the occurrences of the words listed
below, and judged if they a) suggested the reader had some kind of
knowledge/experience, and b) if they added anything of value (including
tone of voice, etc). I left most of the words alone. I looked at the
following words:

- simply/simple
- easy/easier/easiest
- obvious
- just
- merely
- straightforward
- ridiculous

Thanks to Carlton Gibson for guidance on how to approach this issue, and
to Tim Bell for providing the idea. But the enormous lion's share of
thanks go to Adam Johnson for his patient and helpful review.
 2019-09-06 13:27:46 +02:00
Mariusz Felisiak
053ff7e9e6 Fixed typo in docs/internals/contributing/writing-documentation.txt. 2019-09-05 14:06:46 +02:00
Carlton Gibson
ed2d411aa8 Refs #30573 -- Noted to avoid "simple" & co. in Writing Style guide. 
Co-authored-by: Tobias Kunze <r@rixx.de>
 2019-09-05 10:13:31 +02:00
Ramiro Morales
aed89adad5 Fixed #30367 -- Changed "pip install" to "python -m pip install" in docs, comments and hints. 2019-04-18 14:41:15 +02:00
Tim Graham
9caa3e0a29
Doc'd a few contributing guidelines. 2019-03-25 18:26:23 -04:00
Brett Cannon
64b74804c5 Fixed #29334 -- Updated pypi.python.org URLs to pypi.org. 2018-04-17 20:24:27 -04:00
Tim Graham
73cb62a331 Fixed links to Sphinx docs. 2018-03-30 14:29:23 -04:00
Roy Zwambag
fe32fe1619 Used console directive in "Writing documentation". 2018-03-07 16:19:22 -05:00
Ramiro Morales
37c17846ad Fixed #28343 -- Add an OS chooser for docs command line examples. 2018-01-20 12:38:48 -05:00
Claude Paroz
01f658644a Updated various links in docs to avoid redirects 
Thanks Tim Graham and Mariusz Felisiak for review and completion.
 2017-05-22 19:28:44 +02:00
Philip James
2c90981c5f Fixed #26699 -- Mentioned doc theming difference (locally-built vs. website). 2016-06-02 14:06:56 -04:00
Tim Graham
2e1d44e46d Fixed #26637 -- Removed obsolete note in docs/internals/contributing/writing-documentation.txt 2016-05-19 09:11:56 -04:00
Amine
8b5a4fa941 Fixed a broken link in docs/internals/contributing/writing-documentation.txt. 2016-03-19 16:19:01 -04:00
Tim Graham
460dab0b40 Removed obsolete section on "Improving the documentation". 2016-03-15 19:05:54 -04:00
Elif T. Kus
bca9faae95 Fixed #26020 -- Normalized header stylings in docs. 2016-01-22 12:12:17 -05:00
Tim Graham
e519aab43a Fixed #23868 -- Added support for non-unique django-admin-options in docs. 
Also documented missing short command line options to fix #24134. This bumps
the minimum sphinx version required to build the docs to 1.3.4.

Thanks Simon Charette for review.
 2016-01-14 18:21:33 -05:00
Tim Graham
df3d5b1d73 Fixed #26003 -- Added "how the documentation is organized" sections. 
Thanks Daniele Procida for coauthoring.
 2015-12-31 11:35:00 -05:00
Agnieszka Lasyk
1f8dad6915 Fixed #25755 -- Unified spelling of "website". 2015-11-16 06:44:14 -05:00
Curtis Maloney
35440ceab7 Optimized docs images and documented the process. 2015-10-24 14:57:21 -04:00
Tim Graham
aed437d567 Updated release process for new release schedule. 2015-06-25 11:36:17 -04:00
Tim Graham
ccfb5c7408 Removed obsolete literals_to_xrefs.py script. 2015-06-15 10:22:18 -04:00
Steadman
dfdcb3ca22 Improved wording in writing documentation docs. 2015-06-04 11:58:32 +01:00
Erik Romijn
f66c2bdc0f Fixed #23903 -- Configured Sphinx to autogenerate django-admin manpage 2015-03-10 08:12:09 -04:00
darkryder
9ec8aa5e5d Fixed #24149 -- Normalized tuple settings to lists. 2015-02-03 14:59:45 -05:00
Tim Graham
7102b99653 Added best practices for versionadded/changed annotations. 2015-01-09 13:23:29 -05:00
Corey Farwell
37b13033c6 Removed sudo from pip commands in docs. 2014-09-22 15:49:48 -04:00
Tim Graham
fca677fa43 Added sphinx extension to ease generation of ticket links. 2014-08-19 17:40:50 -04:00
Tim Graham
0efd72dc90 Fixed broken links in docs. 2014-08-05 08:23:34 -04:00
Tim Graham
1a3bec4a26 Fixed #18108 -- Added instructions for translating documentation. 
Thanks Claude Paroz.
 2014-07-02 13:16:31 -04:00
Tim Graham
61960dd02c Added a patch review checklist. 2014-06-03 11:55:17 -04:00
Marti Raudsepp
11d453bcad Various documentation typo/spelling fixes 
Errors detected by Topy (https://github.com/intgr/topy), all changes
verified by hand.
 2014-04-23 02:31:49 +03:00
Szczepan Cieślik
a0f2525202 Fixed #22141 -- Added a spelling checker for documentation. 2014-03-07 09:29:23 -05:00
Bouke Haarsma
bed52afee7 Removed usage of to-be-deprecated ADMIN_FOR setting in contributing docs 2013-12-14 16:49:25 +01:00
Alex Gaynor
c0a2daad78 Documented the house style for gender neutral pronouns. 2013-11-30 08:31:58 -05:00
Rogério Yokomizo
1b4b710355 Fixed #21141 -- Update Sphinx URL 
Updated Sphinx URL from http://sphinx.pocoo.org/ to http://sphinx-doc.org/.
 2013-09-22 14:44:09 -03:00
Eric Boersma
4d13cc56de Fixed #21035 -- Changed docs to treat the acronym SQL phonetically. 
The documentation and comments now all use 'an' to
refer to the word SQL and not 'a'.
 2013-09-05 20:14:58 -04:00
Andrew Godwin
f8297f6323 More migration docs, and conversion of all easy syncdb references 2013-07-25 16:19:36 +01:00
Juan Catalano
4e25198ec2 Fixed #20104 -- Changed VersionDirective in order to avoid ambiguity. 
As explained in ticket #20104, the use of versionchanged/versionadded
was confusing.

To solve this ambiguity these directives no longer accept a second
argument but now they only receive the version number (1st arg) and then
a content with the proper comment.
 2013-04-20 17:18:21 +02:00
Tim Graham
5c143cb340 Fixed #19180 - Clarified policy regarding older versions of the docs. 2012-10-25 17:55:42 -04:00
Claude Paroz
8a5d1a6b93 Updated obsolete links in the documentation 2012-06-28 10:49:07 +02:00
Adrian Holovaty
87ff89d12d Fixed #17933 -- Added intro note to writing-documentation.txt 
Based on initial patch by Thomas Westfeld
 2012-06-07 11:32:28 -05:00
Aymeric Augustin
c0e73a4909 Fixed #9995 -- Updated the installation instructions to recommend pip. Also fixed ReST errors. Refs #9112. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17636 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-03-03 09:11:54 +00:00
Luke Plant
d1e5c55258 Fixed many more ReST indentation errors, somehow accidentally missed from [16955] 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16983 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-10-14 00:12:01 +00:00
Ramiro Morales
932b1b8d6d Converted links to external topics so they use intersphinx extension markup. 
This allows to make these links more resilent to changes in the target URLs.
Thanks Jannis for the report and Aymeric Augustin for the patch.

Fixes #16586.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16720 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-09-04 21:17:30 +00:00
Jannis Leidel
127b7fdce8 Fixed #16469 -- Improved documentation of Django internals, including the new backport policy. Many thanks to Aymeric Augustin. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16548 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-07-19 13:16:09 +00:00
Jannis Leidel
8f7b5024b2 Fixed #16414 -- Added standard Windows make batch file for Sphinx. Thanks, Aymeric Augustin. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16547 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-07-19 09:00:24 +00:00
Jannis Leidel
407f62fd31 Fixed #15796 -- Restructured the contributing documentation and added note about newly added Trac abilities. Many thanks to Julien Phalip. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16284 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-05-27 10:49:47 +00:00
Renamed from docs/internals/documentation.txt (Browse further)