Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refactor generating of stories and lint check docs #2441

Merged
merged 1 commit into from
Nov 2, 2023
Merged

Conversation

happz
Copy link
Collaborator

@happz happz commented Oct 30, 2023

The code generating rst files from stories and linter sources was part of docs/conf.py. Hopefully, there will be more generated rst sources from tmt code, therefore doing a small cleanup:

  • code generating doc sources from tmt code has been moved into stand-alone scripts, with a bit of docs and polishing.
  • docs/Makefile and Makefile have been modified to offer nice help and use the new scripts for generating stuff, in a more make-like fashion, instead of letting conf.py control their creation.

Pull Request Checklist

  • implement the feature
  • write the documentation

@happz happz added the documentation Improvements or additions to documentation label Oct 30, 2023
@happz happz added this to the 1.30 milestone Oct 30, 2023
@happz happz force-pushed the docs-generate-scripts branch 6 times, most recently from f8cc089 to 7ed6392 Compare November 1, 2023 11:02
@happz happz force-pushed the docs-generate-scripts branch 4 times, most recently from d517a94 to 98511b6 Compare November 1, 2023 12:26
.readthedocs.yaml Show resolved Hide resolved
@psss psss self-assigned this Nov 2, 2023
Copy link
Collaborator

@psss psss left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice & tidy! Thanks for the improvement! Just one naming suggestion, decision up to you.

docs/Makefile Outdated Show resolved Hide resolved
@psss psss modified the milestones: 1.30, 1.29 Nov 2, 2023
The code generating rst files from stories and linter sources was part
of `docs/conf.py`. Hopefully, there will be more generated rst sources
from tmt code, therefore doing a small cleanup:

* code generating doc sources from tmt code has been moved into
  stand-alone scripts, with a bit of docs and polishing.
* `docs/Makefile` and `Makefile` have been modified to offer nice help
  and use the new scripts for generating stuff, in a more make-like
  fashion, instead of letting `conf.py` control their creation.
@psss psss merged commit 6b423be into main Nov 2, 2023
16 checks passed
@psss psss deleted the docs-generate-scripts branch November 2, 2023 13:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants