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

docs: clarify that feature directories may be outside the project root

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

Les mainteneurs répondent en général sous 2 jours

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
88/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Domaine
documentation

Piste de recherche

Commencez par docs/reference/core.md et docs/guides/monorepo.md, en localisant les descriptions de SPECIFY_FEATURE_DIRECTORY, le tableau des variables d’environnement et la note sur les deux axes. Mettez à jour les deux pages afin de distinguer la racine du projet de l’emplacement des documents de fonctionnalité, de préserver la résolution des chemins relatifs et d’indiquer explicitement que les chemins absolus ou externes sélectionnés explicitement sont autorisés ; vérifiez que les changements concernent uniquement la documentation.

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

Description

triage-nice-to-have

Problem

docs/reference/core.md describes SPECIFY_FEATURE_DIRECTORY as selecting a feature directory “within” the resolved project (environment-variable table and two-axes note). docs/guides/monorepo.md likewise says the selected feature is “within” the project. This implies a containment rule that is not intended or enforced.

Feature directories hold documentation artifacts such as spec.md and plan.md and may intentionally be outside the project root. The project root identifies the Spec Kit project and its command/configuration context; choosing an external feature directory does not relocate or select executable skills, scripts, or extensions.

Requested clarification

  • Update both pages to distinguish the project root from the feature-document location.
  • Preserve the current explanation that relative feature paths resolve against the selected project root, while making clear that an absolute path (or a relative path resolving outside the root) may select an external feature directory.
  • Clarify that the default feature path is under specs/, but explicitly selected feature paths are not restricted to the project root.

This is documentation-only: do not add path containment or change runtime behavior.

Langage dominant
Python
Étoiles
138k
Forks
12.4k
Merge moyen
2 j 14 h
PR mergées (30 j)
164

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 github/spec-kit

Toutes les issues de github/spec-kit

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

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