diff options
| author | Tobias Kunze <r@rixx.de> | 2019-06-17 16:54:55 +0200 |
|---|---|---|
| committer | Mariusz Felisiak <felisiak.mariusz@gmail.com> | 2019-09-06 13:27:46 +0200 |
| commit | 4a954cfd11a5d034491f87fcbc920eb97a302bb3 (patch) | |
| tree | 1c92caae5d8a9b33c51ddd74b4b2061248f3915f /docs/ref/django-admin.txt | |
| parent | addabc492bdc0191ac95d59ec34b56b34086ebb9 (diff) | |
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.
Diffstat (limited to 'docs/ref/django-admin.txt')
| -rw-r--r-- | docs/ref/django-admin.txt | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index b38740669f..eaba4d437d 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -213,7 +213,7 @@ specified in your :setting:`USER`, :setting:`PASSWORD`, etc., settings. * For SQLite, this runs the ``sqlite3`` command-line client. * For Oracle, this runs the ``sqlplus`` command-line client. -This command assumes the programs are on your ``PATH`` so that a simple call to +This command assumes the programs are on your ``PATH`` so that a call to the program name (``psql``, ``mysql``, ``sqlite3``, ``sqlplus``) will find the program in the right place. There's no way to specify the location of the program manually. @@ -400,7 +400,7 @@ By default, ``inspectdb`` creates unmanaged models. That is, ``managed = False`` in the model's ``Meta`` class tells Django not to manage each table's creation, modification, and deletion. If you do want to allow Django to manage the table's lifecycle, you'll need to change the -:attr:`~django.db.models.Options.managed` option to ``True`` (or simply remove +:attr:`~django.db.models.Options.managed` option to ``True`` (or remove it because ``True`` is its default value). Database-specific notes @@ -537,7 +537,7 @@ raise an exception:: post_save.connect(my_handler, sender=MyModel) -You could also write a simple decorator to encapsulate this logic:: +You could also write a decorator to encapsulate this logic:: from functools import wraps @@ -917,7 +917,7 @@ project for some common errors (see the :djadmin:`check` command). If any errors are found, they will be printed to standard output. You can run as many concurrent servers as you want, as long as they're on -separate ports. Just execute ``django-admin runserver`` more than once. +separate ports by executing ``django-admin runserver`` more than once. Note that the default IP address, ``127.0.0.1``, is not accessible from other machines on your network. To make your development server viewable to other @@ -1729,7 +1729,7 @@ Example usage:: .. django-admin-option:: --traceback Displays a full stack trace when a :exc:`~django.core.management.CommandError` -is raised. By default, ``django-admin`` will show a simple error message when a +is raised. By default, ``django-admin`` will show an error message when a ``CommandError`` occurs and a full stack trace for any other exception. Example usage:: |
