Skip to content

Add API template#9

Draft
banchan86 wants to merge 29 commits into
bonsai-rx:mainfrom
banchan86:api-template
Draft

Add API template#9
banchan86 wants to merge 29 commits into
bonsai-rx:mainfrom
banchan86:api-template

Conversation

@banchan86

@banchan86 banchan86 commented Aug 22, 2024

Copy link
Copy Markdown

Resolves #8.

Based off @cjsha and @bparks13 template for https://open-ephys.github.io/bonsai-onix1-docs/index.html

See Readme for usage instructions.

Might have a merge conflict with #7, because the way I started out with those 2 branches was by deleting files from each. But basically keep all the files that are present.

Original unmodified docs: https://bonsai-rx.org/pulsepal/api/Bonsai.PulsePal.ConfigureOutputChannel.html
Online preview of this PR: https://banchan86.github.io/pulsepal_docs_rev/api/Bonsai.PulsePal.ConfigureOutputChannel.html

banchan86 and others added 29 commits August 8, 2024 14:18
From open-ephys/bonsai-onix1-docs@c2e0bd4

Co-authored-by: Cris <cs@open-ephys.org>
Co-authored-by: Brandon Parks <bap@open-ephys.org>
- The original template  has code that enables display of enums values and description  on some of the classes that use them
- Some of it seems to be specific to OE nodes, but I have kept the one in the defineProperties function that applies generally
- Not sure what that section was doing but removing it didnt change anything, so it was probably OE specific
- Final version of OE template that retains all the features we want to port over
- From here on out I am adding new features
- Adds namespace and definitions
- Add inheritance, implements, and derived classes, but leaves out inherited members
Co-authored-by: Cris <cs@open-ephys.org>
- replaceIObservableAndTSource edited to fit new refactored functions
- sortProperties and defineEnumFields refactored

Co-authored-by: Cris <cs@open-ephys.org>
Co-authored-by: Cris <cs@open-ephys.org>
Co-authored-by: Brandon Parks <bap@open-ephys.org>
@banchan86

banchan86 commented Dec 30, 2024

Copy link
Copy Markdown
Author

Converting to draft to work on feedback from DCM.

@banchan86

Copy link
Copy Markdown
Author

On hold as there are significant problems with this approach, especially in pulling information from external types (like Bonsai packages or Bonsai Core). Goncalo is exploring alternative solutions for docfx in general by going through the C# plugin route.

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.

Custom API template to improve documentation user-friendliness

1 participant