summaryrefslogtreecommitdiff
path: root/docs/ref/files
diff options
context:
space:
mode:
authorTobias Kunze <r@rixx.de>2019-06-17 16:54:55 +0200
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2019-09-06 13:27:46 +0200
commit4a954cfd11a5d034491f87fcbc920eb97a302bb3 (patch)
tree1c92caae5d8a9b33c51ddd74b4b2061248f3915f /docs/ref/files
parentaddabc492bdc0191ac95d59ec34b56b34086ebb9 (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/files')
-rw-r--r--docs/ref/files/uploads.txt14
1 files changed, 7 insertions, 7 deletions
diff --git a/docs/ref/files/uploads.txt b/docs/ref/files/uploads.txt
index f67d9c9631..4b58d2a4e2 100644
--- a/docs/ref/files/uploads.txt
+++ b/docs/ref/files/uploads.txt
@@ -12,8 +12,8 @@ Uploaded files
During file uploads, the actual file data is stored in :attr:`request.FILES
<django.http.HttpRequest.FILES>`. Each entry in this dictionary is an
-``UploadedFile`` object (or a subclass) -- a simple wrapper around an uploaded
-file. You'll usually use one of these methods to access the uploaded content:
+``UploadedFile`` object (or a subclass) -- a wrapper around an uploaded file.
+You'll usually use one of these methods to access the uploaded content:
.. method:: UploadedFile.read()
@@ -33,9 +33,9 @@ file. You'll usually use one of these methods to access the uploaded content:
A generator returning chunks of the file. If ``multiple_chunks()`` is
``True``, you should use this method in a loop instead of ``read()``.
- In practice, it's often easiest simply to use ``chunks()`` all the time.
- Looping over ``chunks()`` instead of using ``read()`` ensures that large
- files don't overwhelm your system's memory.
+ In practice, it's often easiest to use ``chunks()`` all the time. Looping
+ over ``chunks()`` instead of using ``read()`` ensures that large files
+ don't overwhelm your system's memory.
Here are some useful attributes of ``UploadedFile``:
@@ -72,8 +72,8 @@ Here are some useful attributes of ``UploadedFile``:
.. note::
- Like regular Python files, you can read the file line-by-line simply by
- iterating over the uploaded file:
+ Like regular Python files, you can read the file line-by-line by iterating
+ over the uploaded file:
.. code-block:: python