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 Thomas Güttler, 7 years ago

Component: UncategorizedDocumentation

comment:2 by Tim Graham, 7 years ago

Summary: What is a "deployment server"?Clarify the term "deployment server" in the documentation
Triage Stage: UnreviewedAccepted
Type: UncategorizedCleanup/optimization

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.

comment:3 by Thomas Güttler, 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 Anton Mo Eriksson, 7 years ago

Owner: changed from nobody to Anton Mo Eriksson
Status: newassigned

comment:5 by Anton Mo Eriksson, 7 years ago

Owner: Anton Mo Eriksson removed
Status: assignednew

comment:6 by Carlton Gibson, 7 years ago

Resolution: wontfix
Status: newclosed

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.

Note: See TracTickets for help on using tickets.
Back to Top