Skip to content

Comments

Helpers for docs#99

Merged
RemDelaporteMathurin merged 9 commits intomainfrom
helpers
Aug 3, 2025
Merged

Helpers for docs#99
RemDelaporteMathurin merged 9 commits intomainfrom
helpers

Conversation

@RemDelaporteMathurin
Copy link
Collaborator

This PR adds the class documentation in the sidebar when selecting a node.

image

The documentation section is collapsible for convenience.

The docstrings are nicely formatted and rendered:
image

How it works:

  • Backend function which returns the python class docstrings
  • Using sphinx to convert the docstrings to shiny HTML (similar to the way sphinx does it when generating API references)

This is particularly nice because it offloads the documentation maintenance for basic pathsim blocks to pathsim directly, and for custom nodes, this has to be taken care of by the custom node creators (ie. future plugins)

@RemDelaporteMathurin RemDelaporteMathurin moved this to In progress in PathView release Aug 2, 2025
@RemDelaporteMathurin RemDelaporteMathurin self-assigned this Aug 2, 2025
@RemDelaporteMathurin RemDelaporteMathurin merged commit 6340971 into main Aug 3, 2025
3 checks passed
@RemDelaporteMathurin RemDelaporteMathurin deleted the helpers branch August 3, 2025 01:52
@github-project-automation github-project-automation bot moved this from In progress to Done in PathView release Aug 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant