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

📝 Initialize Documentation on ReadTheDocs #98

Merged
merged 1 commit into from
Sep 5, 2022
Merged

Conversation

burgholzer
Copy link
Member

This PR adds the initial configuration and infrastructure for building proper project documentation on ReadTheDocs.

Building the documentation locally is as easy as

nox -rs docs -- serve

nox is best installed via pipx install nox (or brew install nox if you are on macOS). If you don't have pipx (pip for applications) you can install it with pip install pipx (or brew install pipx if you are on macOS).

At the moment the documentation is pretty much empty. Filling it with content will be done in a separate PR.

Signed-off-by: burgholzer <burgholzer@me.com>
@burgholzer burgholzer added the documentation Improvements or additions to documentation label Sep 5, 2022
@burgholzer burgholzer self-assigned this Sep 5, 2022
@burgholzer burgholzer enabled auto-merge (squash) September 5, 2022 16:04
@codecov
Copy link

codecov bot commented Sep 5, 2022

Codecov Report

Merging #98 (0c23a09) into main (e6c91d8) will not change coverage.
The diff coverage is n/a.

@@          Coverage Diff          @@
##            main     #98   +/-   ##
=====================================
  Coverage   91.1%   91.1%           
=====================================
  Files         20      20           
  Lines       1726    1726           
  Branches     411     411           
=====================================
  Hits        1573    1573           
  Misses       153     153           

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

@burgholzer burgholzer merged commit 1eea8c1 into main Sep 5, 2022
@burgholzer burgholzer deleted the initial-docs branch September 5, 2022 16:50
burgholzer added a commit that referenced this pull request Sep 5, 2022
Now that the foundation has been laid in #98, it is time to get things to work properly. 
Of course, the build failed right away because no proper version of Z3 was available for the documentation build.
This PR fixes these build errors by updating the Ubuntu image used to build the docs.
The updated image (Ubuntu-22.04) comes with a recent enough z3 version to build QMAP.

Signed-off-by: burgholzer <burgholzer@me.com>
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.

1 participant