mirror of
https://github.com/github/spec-kit.git
synced 2026-08-03 06:26:30 +08:00
ad601e5d52
* docs: add PyPI as second supported install route (#3425) The specify-cli package is now officially published to PyPI via the publish-pypi.yml trusted-publishing workflow. Document PyPI as a supported install route alongside the GitHub source install: - Revise the outdated "not affiliated" warning in installation.md to reflect that specify-cli on PyPI is an official, maintained channel. - Add an "Install from PyPI" section and list PyPI under alternative package managers. - Add a dedicated docs/install/pypi.md guide (install, pin version, verify, upgrade, uninstall). - Add the PyPI guide to the docs TOC. - Mention the PyPI route in the README quick start. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: refine PyPI install guidance from review (#3516) Address review feedback for the PyPI install documentation: - Reword the verification guidance so `specify version` is described as a local version/runtime check rather than proof of package provenance. - Clarify that upgrading a pinned `uv tool` install to the newest PyPI release requires an unpinned reinstall command. - Note that `specify self upgrade` rebuilds `uv tool` and `pipx` installs from the GitHub source release URL rather than preserving a PyPI-based installation. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: clarify PyPI verification and upgrade guidance Assisted-by: GitHub Copilot (model: MAI-Code-1-Flash, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: point PyPI provenance check to source metadata Address review feedback: version/list commands do not reveal install provenance. Direct readers to the source metadata their package manager records (pipx list --json, PEP 610 direct_url.json) to confirm whether an install came from PyPI or a Git URL, and note pip show cannot see uv/pipx-managed environments. Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
81 lines
1.9 KiB
YAML
81 lines
1.9 KiB
YAML
# Home page
|
|
- name: Home
|
|
href: index.md
|
|
|
|
# Getting started section
|
|
- name: Getting Started
|
|
items:
|
|
- name: Installation
|
|
href: installation.md
|
|
- name: Quick Start
|
|
href: quickstart.md
|
|
- name: Upgrade
|
|
href: upgrade.md
|
|
- name: Install uv
|
|
href: install/uv.md
|
|
- name: Install from PyPI
|
|
href: install/pypi.md
|
|
- name: Install with pipx
|
|
href: install/pipx.md
|
|
- name: One-time Usage (uvx)
|
|
href: install/one-time.md
|
|
- name: Enterprise / Air-Gapped
|
|
href: install/air-gapped.md
|
|
|
|
# Reference
|
|
- name: Reference
|
|
items:
|
|
- name: Overview
|
|
href: reference/overview.md
|
|
- name: Core Commands
|
|
href: reference/core.md
|
|
- name: Integrations
|
|
href: reference/integrations.md
|
|
- name: Extensions
|
|
href: reference/extensions.md
|
|
- name: Presets
|
|
href: reference/presets.md
|
|
- name: Workflows
|
|
href: reference/workflows.md
|
|
- name: Bundles
|
|
href: reference/bundles.md
|
|
- name: Authentication
|
|
href: reference/authentication.md
|
|
|
|
# Concepts
|
|
- name: Concepts
|
|
items:
|
|
- name: What is SDD?
|
|
href: concepts/sdd.md
|
|
- name: Spec Persistence Models
|
|
href: concepts/spec-persistence.md
|
|
- name: Handling Complex Features
|
|
href: concepts/complex-features.md
|
|
|
|
# Development workflows
|
|
- name: Development
|
|
items:
|
|
- name: Local Development
|
|
href: local-development.md
|
|
- name: Evolving Specs
|
|
href: guides/evolving-specs.md
|
|
- name: Monorepos
|
|
href: guides/monorepo.md
|
|
|
|
# Community
|
|
- name: Community
|
|
href: community/overview.md
|
|
items:
|
|
- name: Overview
|
|
href: community/overview.md
|
|
- name: Extensions
|
|
href: community/extensions.md
|
|
- name: Presets
|
|
href: community/presets.md
|
|
- name: Bundles
|
|
href: community/bundles.md
|
|
- name: Walkthroughs
|
|
href: community/walkthroughs.md
|
|
- name: Friends
|
|
href: community/friends.md
|