Skip to content

Docs for generated repo#16

Merged
CasperWA merged 8 commits intomasterfrom
cwa/close-5-docs-for-generated-repo
Feb 9, 2022
Merged

Docs for generated repo#16
CasperWA merged 8 commits intomasterfrom
cwa/close-5-docs-for-generated-repo

Conversation

@CasperWA
Copy link
Contributor

@CasperWA CasperWA commented Jan 31, 2022

Closes #5

This adds a MkDocs framework for serving documentation in the generated repository.

It might be nice to add extra pages to showcase the documentation framework - but this PR focuses on setting up the framework first.

Also, documentation for the actual template repository would be nice as well, however, I think it makes more sense to write this documentation in the oteapi-core documentation.

Add a build docs test step for the template.
Add the invoke tasks to pre-commit.
Be consistent: Use asterisks for italic/bold.
Disable MD033 markdownlint message (usage of HTML code, which is
necessary for the table, where `<br>` is used to create line breaks).
This was an issue found in oteapi-core, also found here.
@CasperWA CasperWA marked this pull request as ready for review January 31, 2022 15:48
@CasperWA CasperWA requested review from kriwiik and lovfall January 31, 2022 15:48
Copy link
Contributor

@jesper-friis jesper-friis left a comment

Choose a reason for hiding this comment

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

Looks good

@CasperWA CasperWA merged commit 5ba4e69 into master Feb 9, 2022
@CasperWA CasperWA deleted the cwa/close-5-docs-for-generated-repo branch February 9, 2022 08:32
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.

Add documentation framework for the generated repository

2 participants