Subdirectives are not properly indented in the TOC
Nobody has claimed this yet.
- Dominant language
- XSLT
- Stars
- 89
- Forks
- 60
- Avg merge
- 19h 11m
- Merged PRs (30d)
- 12
Description
Feature Overview
Some Nginx modules define new configuration blocks with a bunch of directives there, e.g. http://nginx.org/en/docs/http/ngx_http_upstream_module.html (and there many more examples in N+).
It would be helpful to see such subdirectives indented in the TOC, i.e. instead of
Directives
upstream
server
zone
state
...
it should be
Directives
upstream
server
zone
state
...
Alternatives Considered
No response
Additional Context
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the documentation TOC generation entry point and inspect how directive nesting is represented for NGINX modules such as the upstream module. Confirm the current flat output and trace where parent-child relationships are available. Done means subdirectives such as server, zone, and state render indented beneath upstream in the TOC.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- nginx
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100