nginx / nginx/nginx.org

"Configuring HTTPS servers" mentions unsupported directive `ssl`

Open
#113 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
XSLT
Stars
89
Forks
60
Avg merge
19h 11m
Merged PRs (30d)
12

Description

https://nginx.org/en/docs/http/configuring_https_servers.html#single_http_https_server has the following note:

The use of the ssl directive in modern versions is thus discouraged.

The ssl directive was removed in 1.25.1 and is not present in any of the supported versions. It feels like "discouraged" is not strong enough to reflect that.

The relevant paragraph starts with "Prior to 0.7.14", so I doubt this note has any value except historical nowadays.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked “Configuring HTTPS servers” page and locate the paragraph beginning “Prior to 0.7.14.” Check how that page is sourced in the nginx.org documentation, then update the note so it accurately reflects that the ssl directive is removed from supported versions, or remove the obsolete historical text. Verify the rendered page afterward.

Written by the indexing model from the issue text.

Assessment

Tech stack
nginx
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.