Conversation
nscuro
commented
Apr 29, 2026
- Specifies all configs in property name format to better align with the rest of the docs.
- Fixes all vale lint warnings.
- Adds abbreviation for LDAP.
* Specifies all configs in property name format to better align with the rest of the docs. * Fixes all vale lint warnings. * Adds abbreviation for LDAP. Signed-off-by: nscuro <nscuro@protonmail.com>
There was a problem hiding this comment.
Pull request overview
Updates the LDAP administration guide to better align configuration examples with the docs’ property-name format, while also addressing Vale linting by adding/accepting relevant terminology (including LDAP as an abbreviation).
Changes:
- Rewrites LDAP configuration examples to use
dt.*property names instead of environment variables and adds clearer explanatory callouts. - Updates wording, headings, and links in the LDAP guide for consistency and readability.
- Extends docs abbreviations and Vale accepted vocabulary to include LDAP and directory-related terms used in the guide.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/includes/abbreviations.md | Adds an LDAP abbreviation expansion used across the docs site. |
| docs/guides/administration/configuring-ldap.md | Converts examples to property-name format and refines narrative, links, and headings. |
| .vale/styles/config/vocabularies/DependencyTrack/accept.txt | Adds accepted terms (e.g., LDAP, Active Directory, ApacheDS) to satisfy Vale. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| !!! tip | ||
| Dependency-Track substitutes the `{0}` placeholder in `dt.ldap.auth.username.format` | ||
| with the username entered at login. |
There was a problem hiding this comment.
dt.ldap.auth.username.format examples and the tip use a {0} placeholder, but the configuration reference for that property currently documents %s as the substitution variable (docs/reference/configuration/properties.md under dt.ldap.auth.username.format). Please align the placeholder syntax between this guide and the reference (either update the guide to %s or update the reference to {0}), otherwise readers may copy a format string that won't work at runtime.