Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

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

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#26,263 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@dave123981 y travaille déjà.

Depuis le 4/10/2026.

  • #26268 par @dave123981 — ouverte

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
88/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
docker
Domaine
documentation

Piste de recherche

Commencez par content/manuals/desktop/enterprise/hardened-desktop/settings-management/configure-json-file.md et comparez son tableau Container proxy avec settings-reference.md et les exemples de paramètres imbriqués situés à proximité. Mettez à jour le tableau afin que pac et embeddedPac soient clairement affichés sous containersProxy, puis vérifiez que la documentation rendue correspond à l’exemple JSON et n’implique pas l’existence de clés de niveau supérieur distinctes.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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

Langage dominant
Markdown
Étoiles
4.7k
Forks
8.5k
Merge moyen
2 j 1 h
PR mergées (30 j)
139

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de docker/docs

Toutes les issues de docker/docs

Issues similaires

Plus d'issues Documentation

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.