Skip to content

Create a documentation site#33

Merged
php1ic merged 6 commits into
mainfrom
rtd
May 20, 2026
Merged

Create a documentation site#33
php1ic merged 6 commits into
mainfrom
rtd

Conversation

@php1ic

@php1ic php1ic commented May 20, 2026

Copy link
Copy Markdown
Owner

Start working on #32

php1ic added 5 commits May 20, 2026 21:29
Everything in these directories are created by sphinx so we do not need
to track them.
The docstrings should be enough to remove the need to manually write
anything related to the API and low level code. We will still however
write some additional content as time goes on.
This is lifted from their front page with an alteration to use the docs
dependency rather than a requirements.txt file.
Might need to tweak the `on` section as we only really want to update
the site on a new release. Although we do want to ensure the various
files haven't been broken.
@codecov-commenter

codecov-commenter commented May 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.55%. Comparing base (692ed71) to head (1d16cb3).

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #33   +/-   ##
=======================================
  Coverage   99.55%   99.55%           
=======================================
  Files          15       15           
  Lines         448      448           
=======================================
  Hits          446      446           
  Misses          2        2           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

I want to include the README as-is in the docs website. As a result a
relative path to another file in the repo no longer makes sense so we
need to use the absolute path.
@php1ic

php1ic commented May 20, 2026

Copy link
Copy Markdown
Owner Author

The website looks as expected locally and all the pipelines are passing, but I can't see the project when trying to add it on my read the docs account page. This may be because the initial setup has to be with the main branch.

The pages, and general usability, are very rough as it currently is, but I'm going to merge this PR anyway to try and get the site live. I'll create another PR to polish the content.

@php1ic php1ic merged commit 3d06960 into main May 20, 2026
14 checks passed
@php1ic php1ic deleted the rtd branch May 20, 2026 22:12
@php1ic php1ic mentioned this pull request May 22, 2026
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.

2 participants