Opened 7 months ago

Closed 10 days 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 Changed 7 months ago by Thomas Güttler

Component: UncategorizedDocumentation

comment:2 Changed 7 months ago by Tim Graham

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 Changed 7 months ago by Thomas Güttler

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 Changed 10 days ago by Anton Mo Eriksson

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

comment:5 Changed 10 days ago by Anton Mo Eriksson

Owner: Anton Mo Eriksson deleted
Status: assignednew

comment:6 Changed 10 days ago by Carlton Gibson

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