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

Add Sphinx-based docs including a markdown version of the vocabulary guidelines v2.0 #93

Merged
merged 4 commits into from
Oct 12, 2024

Conversation

dalito
Copy link
Member

@dalito dalito commented Oct 10, 2024

We use Sphinx with the Furo theme and the MyST parser. So contributors can use markdown (as here on GitHub) and don't have to know the older reST markup language.

The documentation looks already quite nice. Light and dark modes are supported. I have adjusted the main colors to match the colors in the logo. The dark logo version has a brighter blue to increase the contrast to the background.

image

ToDos before this PR is ready for merging:

  • Figure out how to publish alongside the current vocabulary docs and the vocabulary RDF files
  • Add building of doc-site to GitHub actions

Deferred to later PRs:

Closes #91

@dalito dalito self-assigned this Oct 10, 2024
Changes all gh-actions files to use hash-based
identifiers for the used external actions.
Change from Python 3.11 to 3.12
@dalito dalito added the documentation Improvements or additions to documentation label Oct 12, 2024
@dalito dalito merged commit e81ea89 into main Oct 12, 2024
1 check passed
@dalito dalito deleted the issue91-docs branch October 12, 2024 10:32
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.

📝 Provide guidelines also as searchable documentation
1 participant