[Django] #27298: Unclear wording in the documentation

8 views
Skip to first unread message

Django

unread,
Sep 29, 2016, 6:28:32 PM9/29/16
to django-...@googlegroups.com
#27298: Unclear wording in the documentation
-------------------------------+--------------------
Reporter: Victor Porton | Owner: nobody
Type: Bug | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------
https://docs.djangoproject.com/en/1.10/topics/testing/advanced/ says:
"After each test, Django calls flush to reset the database state"

It is it flushed after every test method? or only after all methods of a
test class run (without flushing between methods of the same class)?

--
Ticket URL: <https://code.djangoproject.com/ticket/27298>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

Django

unread,
Sep 29, 2016, 6:46:25 PM9/29/16
to django-...@googlegroups.com
#27298: Unclear "after each test" wording in the documentation
-------------------------------+--------------------------------------

Reporter: Victor Porton | Owner: nobody
Type: Bug | Status: new
Component: Documentation | Version: 1.10
Severity: Normal | Resolution:
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------------------------
Changes (by Tim Graham):

* needs_better_patch: => 0
* needs_tests: => 0
* needs_docs: => 0


Comment:

My understanding is that in Python, "test" is a synonym for "test method."
For example the test runner says something like, "Ran 85 tests" at the end
of a test suite run. I'm not sure if the wording needs to be clarified or
not. Likely there are other places in the documentation that use "test" as
a shorthand for "test method". This is also the case in Python's unittest
documentation.

--
Ticket URL: <https://code.djangoproject.com/ticket/27298#comment:1>

Django

unread,
Sep 30, 2016, 3:43:10 AM9/30/16
to django-...@googlegroups.com
#27298: Unclear "after each test" wording in the documentation
-------------------------------+--------------------------------------
Reporter: Victor Porton | Owner: nobody
Type: Bug | Status: closed
Component: Documentation | Version: 1.10
Severity: Normal | Resolution: wontfix
Keywords: | Triage Stage: Unreviewed

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0

Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------------------------
Changes (by Claude Paroz):

* status: new => closed
* resolution: => wontfix


Comment:

Agreed with Tim.

--
Ticket URL: <https://code.djangoproject.com/ticket/27298#comment:2>

Reply all
Reply to author
Forward
0 new messages