Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

[docs-scanner] Container proxy table misleadingly presents nested properties as separate parameters

Offen Anfängerfreundlich
  • Stimmt etwas nicht?
#26,263 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@dave123981 arbeitet bereits daran.

Seit 04.10.2026.

  • #26268 von @dave123981 — offen

Bewertung

Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Anfängerfreundlichkeit
88/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
docker
Bereich
documentation

Rechercherichtung

Beginne mit content/manuals/desktop/enterprise/hardened-desktop/settings-management/configure-json-file.md und vergleiche dessen Tabelle zu Container proxy mit settings-reference.md und den Beispielen für verschachtelte Einstellungen in der Nähe. Aktualisiere die Tabelle so, dass pac und embeddedPac eindeutig unter containersProxy angezeigt werden, und überprüfe anschließend, dass die gerenderte Dokumentation mit dem Beispiel-JSON übereinstimmt und keine separaten Top-Level-Schlüssel impliziert.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

area/desktop area/enterprise status/confirmed

File: content/manuals/desktop/enterprise/hardened-desktop/settings-management/configure-json-file.md

Issue

The "Container proxy" section table presents pac and embeddedPac as if they are separate top-level parameters, when they are actually nested properties within the containersProxy object.

From the table:

Parameter OS Description Version
containersProxy Configures the proxy for docker image pull (always enforced) and running container outbound traffic (enforced when transparentPorts is set). For more information see Air-Gapped Containers.
pac Specifies a PAC file URL. For example, "pac": "http://containerproxy/proxy.pac".
embeddedPac Specifies an embedded PAC (Proxy Auto-config) script. For example, "embeddedPac": "function FindProxyForURL(url, host) { return \"PROXY 192.168.92.1:2003\"; }". This setting takes precedence over HTTP, HTTPS, Proxy bypass and PAC server URL.

However, the example JSON in the same file shows the correct structure:

"containersProxy": {
  "locked": true,
  "mode": "manual",
  "http": "",
  "https": "",
  "exclude": [],
  "pac": "",
  "embeddedPac": "",
  "transparentPorts": ""
}

And settings-reference.md correctly documents this as a single JSON object with nested properties.

Why this matters

Administrators reading the table might incorrectly create their JSON configuration with pac and embeddedPac as separate top-level keys instead of nested within containersProxy. This would result in invalid configuration that Docker Desktop would ignore or reject.

Suggested fix

Restructure the table to show the nested relationship, similar to how other nested settings are documented in the same file (e.g., enhancedContainerIsolation.dockerSocketMount.imageList). Alternatively, present containersProxy as a single entry with a JSON example showing all its properties, matching the approach used in settings-reference.md.

Found by nightly documentation quality scanner

Vorherrschende Sprache
Markdown
Sterne
4.7k
Forks
8.5k
Ø Merge
2 T. 1 Std.
Gemergte PRs (30 T.)
139

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus docker/docs

Alle Issues in docker/docs

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.