Skip to content

Update docs after install overhaul#469

Merged
ebrahimebrahim merged 5 commits into
mainfrom
update-docs-after-install-overhaul
Jun 12, 2026
Merged

Update docs after install overhaul#469
ebrahimebrahim merged 5 commits into
mainfrom
update-docs-after-install-overhaul

Conversation

@ebrahimebrahim

@ebrahimebrahim ebrahimebrahim commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Update docs after #444

The main changes that happened to the docs are easiest to see in commit 966ce87
The new README can be previewed here: https://github.com/OpenwaterHealth/openlifu-python/blob/update-docs-after-install-overhaul/README.md
Now there's a "recommended isntall" and "minimal install" and "install with selected features"

While I was at it, I made a few other unrelated changes that were bugging me:

  • renamed CLAUDE.md to AGENTS.md to cover more general cases
  • moved .github/CONTRIBUTING.md out to the repo root so that it has more visibility -- github still recognizes it in the repo root (@dblizinski)
  • converted README from rst to markdown. It was only rst for historical reasons, and it has been our only rst file

Keep the contributing guide in the repository root so it is easier to find in local checkouts and the GitHub file browser. GitHub recognizes root CONTRIBUTING.md for contributor prompts, so the move preserves the existing GitHub behavior.
The Sphinx API docs recursively import openlifu modules. After the optional-dependency split, the docs environment needs the mesh, db, and cloud extras so those imports resolve during autosummary generation without pulling in simulation binaries or hardware SDK dependencies.

@peterhollender peterhollender left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reasonable updates

@ebrahimebrahim ebrahimebrahim merged commit 45c0104 into main Jun 12, 2026
10 checks passed
@dblizinski

dblizinski commented Jun 12, 2026 via email

Copy link
Copy Markdown
Contributor

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.

3 participants