[Django] #28470: Document additional system requirements for unit tests

[Django]

#28470: Document additional system requirements for unit tests
-------------------------------------+-------------------------------------
Reporter: jnp1961 | Owner: nobody
Type: | Status: new
Uncategorized |
Component: | Version: 1.11
Documentation | Keywords: writing-code unit-
Severity: Normal | tests
Triage Stage: | Has patch: 1
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
Running Ubuntu 16.04 and downloaded python3 from github and ran `pip
install -r requirements/py3.txt`. This failed with `Failed building wheel
for pylibmc`. To address needed to install system development packages.
This step has been added to the writing-code/unit-tests document.

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

[Django]

#28470: Document additional system requirements for unit tests
-------------------------------------+-------------------------------------

Reporter: Jeff Poulton | Owner: Jeff
| Poulton
Type: Uncategorized | Status: assigned
Component: Documentation | Version: 1.11
Severity: Normal | Resolution:
Keywords: writing-code unit- | Triage Stage:
tests | Unreviewed
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jeff Poulton):

* status: new => assigned
* owner: nobody => Jeff Poulton

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

[Django]

#28470: Document additional system requirements for unit tests
-------------------------------------+-------------------------------------

Reporter: Jeff Poulton | Owner: Jeff
Type: | Poulton
Cleanup/optimization | Status: assigned

Component: Documentation | Version: 1.11
Severity: Normal | Resolution:
Keywords: writing-code unit- | Triage Stage:
tests | Unreviewed

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Tim Graham):

* type: Uncategorized => Cleanup/optimization

Comment:

This has come up before (e.g. ticket:27876#comment:3) and it's my opinion
that it's not Django's job to document how to install dependencies of
other third party packages. In my experience, doing a web search for the
error message usually leads to the solution. If you wanted to propose
adding links to the packages instructions for installing their
dependencies, we could consider that.

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

[Django]

#28470: Document additional system requirements for unit tests
-------------------------------------+-------------------------------------

Reporter: Jeff Poulton | Owner: Jeff
Type: | Poulton

Cleanup/optimization | Status: closed
Component: Documentation | Version: 1.11
Severity: Normal | Resolution: wontfix

Keywords: writing-code unit- | Triage Stage:
tests | Unreviewed

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Tim Graham):

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

Comment:

I think the paragraph the follows your proposed addition is good enough
advice:

Installing the requirements will likely require some operating system
packages that your computer doesn't have installed. You can usually figure
out which package to install by doing a Web search for the last line or so
of the error message. Try adding your operating system to the search query
if needed.

--
Ticket URL: <https://code.djangoproject.com/ticket/28470#comment:3>