Skip to content

Conversation

@stanislaw
Copy link
Collaborator

Configuring StrictDoc with a Python file provides more flexibility when a user has to:

  • Create custom generators
  • Remove the existing generators
  • Customize requirement and document tree validations
  • Customize project statistics

When the Python config feature becomes stable, the TOML config will be deprecated and removed from StrictDoc after some time.

@stanislaw stanislaw added this to the 2025-Q4 milestone Oct 4, 2025
… a Python file instead of TOML

Configuring StrictDoc with a Python file provides more flexibility when a user
has to:

- Create custom generators
- Remove the existing generators
- Customize requirement and document tree validations
- Customize project statistics

When the Python config feature becomes stable, the TOML config will be deprecated and removed from StrictDoc after some time.
@stanislaw stanislaw merged commit e504044 into main Oct 5, 2025
33 of 42 checks passed
@stanislaw stanislaw deleted the stanislaw/q branch October 5, 2025 09:02
@stanislaw
Copy link
Collaborator Author

stanislaw commented Oct 5, 2025

@thseiler @haxtibal

As discussed with both of you at different times during the office hours, I am moving to a Python config incrementally. I have not documented the change yet, because I want to give it some testing first. You should get an idea of the new approach by looking at how StrictDoc's own strictdoc_config.py looks like now.

The TOML file will go away because it is much easier to provide more advanced configurations with Python directly. Also, the Python config is type-aware, and an IDE can give more information about the possible options.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants