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

Add cross-links to documentation #40

Open
lazappi opened this issue Oct 15, 2024 · 3 comments
Open

Add cross-links to documentation #40

lazappi opened this issue Oct 15, 2024 · 3 comments
Labels
documentation Improvements or additions to documentation

Comments

@lazappi
Copy link
Collaborator

lazappi commented Oct 15, 2024

Add relevant cross-links between README, vignettes, man pages etc. and the main Python Lamin documentation

@lazappi lazappi added the documentation Improvements or additions to documentation label Oct 15, 2024
@Zethson
Copy link
Member

Zethson commented Oct 16, 2024

Is there any reasonable way for you to use sphinx? If it were possible we could make a ton of useful references to the Python docs.

@falexwolf
Copy link
Member

I asked that question 2 weeks ago in the kick-off and the answer from Robrecht & Luke was: "we have never seen an R package documented with Sphinx".

@lazappi
Copy link
Collaborator Author

lazappi commented Oct 17, 2024

The R package structure is a lot more restricted than for Python and there is a particular format you have to use for function documentation. The current website uses {pkgdown} which takes that format and converts it to HTML.

I did find a package that converts to ReadTheDocs format instead but we would have to try it out to see if it works and makes cross-linking easier.

I guess you could make the vignettes as a separate sphinx site but then lose the function documentation and lot of automated checking.

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

No branches or pull requests

3 participants