Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

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

Aberta Para iniciantes
#4,738 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
88/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Domínio
documentation

Direção de pesquisa

Comece por docs/reference/core.md e docs/guides/monorepo.md, localizando as descrições de SPECIFY_FEATURE_DIRECTORY, a tabela de variáveis de ambiente e a observação sobre os dois eixos. Atualize ambas as páginas para distinguir a raiz do projeto do local dos documentos da funcionalidade, preservar a resolução de caminhos relativos e declarar explicitamente que caminhos absolutos ou externos selecionados explicitamente são permitidos; verifique se as alterações são somente de documentação.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.

Linguagem predominante
Python
Estrelas
138k
Forks
12.4k
Merge médio
3d 2h
PRs com merge (30d)
169

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de github/spec-kit

Todas as issues de github/spec-kit

Issues semelhantes

Mais issues de Python

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.