Visitar URL original
📝 docs: mark the INI configuration format as deprecated by gaborbernat · Pull Request #4017 · tox-dev/tox · GitHub
Skip to content

📝 docs: mark the INI configuration format as deprecated - #4017

Merged
gaborbernat merged 1 commit into
tox-dev:mainfrom
gaborbernat:docs-ini-deprecated
Aug 10, 2026
Merged

gaborbernat merged 1 commit into
tox-dev:mainfrom
gaborbernat:docs-ini-deprecated

Conversation

@gaborbernat

@gaborbernat gaborbernat commented Aug 10, 2026 •

Copy link
Copy Markdown
Member

The configuration reference described INI as a supported alternative to TOML ("INI remains supported and is more concise for some patterns"), and users quote that line back when asking for new INI features, as in tox-ini-fmt#359. That wording contradicts the project position that INI is frozen. 📝

The tutorial, the configuration reference, and the migration how-to now state that INI is deprecated: it keeps working for existing projects, but it receives no new features and may be removed in a future major release. Every INI example tab is relabeled INI (deprecated); sphinx-inline-tabs syncs tabs by label, so the consistent rename keeps tab groups switching together. The configuration discovery list, its mermaid diagram, and the man page carry the same marker, and the reference links to the migration how-to.

The tutorial now creates a tox.toml from the start and no longer suggests generating a tox.ini via tox quickstart.

🤖 Generated with Claude Code

@gaborbernat gaborbernat changed the title Document that the INI format is deprecated 📝 docs: mark the INI configuration format as deprecated Aug 10, 2026
@gaborbernat gaborbernat added area:documentation feature:deprecate something already exists, but shouldn't really :) labels Aug 10, 2026
@gaborbernat
gaborbernat merged commit da75cad into tox-dev:main Aug 10, 2026
56 of 57 checks passed
@gaborbernat
gaborbernat deleted the docs-ini-deprecated branch October 3, 2026 15:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentation bot:chronographer:provided feature:deprecate something already exists, but shouldn't really :)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant