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

Adding Docs Workflow #186

Merged
merged 19 commits into from
Oct 16, 2023
Merged

Adding Docs Workflow #186

merged 19 commits into from
Oct 16, 2023

Conversation

gordonkoehn
Copy link
Collaborator

@gordonkoehn gordonkoehn commented Oct 13, 2023

This PR implements a workflow to automatically generate documentation using mkdocs in this repository. The workflow was copied from https://github.com/cbg-ethz/bmi

@pawel-czyz This is my first progress on the documentation. I think I understand how to use mkdocs and quarto now. I shamelessly plagiarised the README soft link trick and contributing page from your BMI repo. I hope that's ok! :)

So far I have managed to

  • get the API generated,
  • added a contributing page
  • put the READ.md as a placeholder (needs updating)
  • I added my first small tutorial on how to run a single SCITE MCMC with the functions themselves (I am aiming to add more on workflows, distances and analytics)

I tested it all with poetry mkdocs serve, but I understand that the deployment on github pages is not something I can test and will happen automatically with the github workflow that I copied from BMI.

What do you think? Shall we try a first deployment as this - I'll update with more content later this week.

@gordonkoehn gordonkoehn linked an issue Oct 13, 2023 that may be closed by this pull request
@gordonkoehn gordonkoehn marked this pull request as ready for review October 13, 2023 12:02
@gordonkoehn gordonkoehn self-assigned this Oct 16, 2023
@gordonkoehn gordonkoehn added the 🕮 action: documentation Improvements or additions to documentation label Oct 16, 2023
Copy link
Member

@pawel-czyz pawel-czyz left a comment

Choose a reason for hiding this comment

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

Great work! As you mentioned, we need to let GitHub build the documentation and then we can see whether everything works.
(Usually once I know that the workflow works properly, I use mkdocs locally to fix the issues.)

Would you mind merging?

@gordonkoehn gordonkoehn merged commit 377a87a into main Oct 16, 2023
1 check passed
@gordonkoehn gordonkoehn deleted the gordon/docs branch October 16, 2023 11:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🕮 action: documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Generate Documentation
2 participants