Opened 7 years ago
Closed 7 years ago
#28743 closed Cleanup/optimization (wontfix)
Clarify the term "deployment server" in the documentation
Reported by: | Thomas Güttler | Owned by: | |
---|---|---|---|
Component: | Documentation | Version: | 1.11 |
Severity: | Normal | Keywords: | |
Cc: | Triage Stage: | Accepted | |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
From the docs:
If you need to run system checks on your deployment server, trigger them explicitly using check.
Source: https://docs.djangoproject.com/en/1.11/topics/checks/
What is a "deployment server"?
I tried tried to find the answer in the "Deployment checklist" (https://docs.djangoproject.com/en/1.11/howto/deployment/checklist/)
But no luck. There the I find
"application server" and "web server" and "development server".
... I am confused :-)
A glossary or definition of the basics words would make it clear.
Change History (6)
comment:1 by , 7 years ago
Component: | Uncategorized → Documentation |
---|
comment:2 by , 7 years ago
Summary: | What is a "deployment server"? → Clarify the term "deployment server" in the documentation |
---|---|
Triage Stage: | Unreviewed → Accepted |
Type: | Uncategorized → Cleanup/optimization |
comment:3 by , 7 years ago
It is strange, that the term "deployment server" is not used in the docs with the title "Deployment checklist".
Please take the fundamental words serious. Especially in this area most dev teams go their own way. That's why I think a definition/glossary would help.
comment:4 by , 7 years ago
Owner: | changed from | to
---|---|
Status: | new → assigned |
comment:5 by , 7 years ago
Owner: | removed |
---|---|
Status: | assigned → new |
comment:6 by , 7 years ago
Resolution: | → wontfix |
---|---|
Status: | new → closed |
I'm going to close this as wontfix. The proposed PR (whilst fine in itself) wasn't any great gain, and just created work for the translation teams.
Maybe a glossary would be a good addition to the docs — but this would need to be contributor driven.
The best way to push that forwards would be an example of how it would begin (some terms and definitions) and then a discussion on Django Developers to see if there was support for it. That would be a separate issue than this one.
Short of such a development, I do think "deployment server" really should be clear enough.
It's the server to which you deploy your code. I wonder if a web search for what is a deployment server would have answered your question. I'm not sure if it merits further explanation in Django's documentation as I guess it assumes some basic knowledge in web development but you can either propose a patch or close this issue if this answer seems sufficient.