Skip to content

Collapse docstrings in documentation to allow for easier navigation#4758

Merged
thofma merged 1 commit intomasterfrom
th/testcollaps
Apr 24, 2025
Merged

Collapse docstrings in documentation to allow for easier navigation#4758
thofma merged 1 commit intomasterfrom
th/testcollaps

Conversation

@thofma
Copy link
Copy Markdown
Collaborator

@thofma thofma commented Mar 22, 2025

I noticed that with collapsed docstrings (by default) the pages look much clearer if single docstrings are long (because of examples). There is a button to do it at the top right corner, but l add it here directly, so that we can compare it easier.

Collapsed by default: https://docs.oscar-system.org/previews/PR4758/CommutativeAlgebra/ideals/
Current verion: https://docs.oscar-system.org/dev/CommutativeAlgebra/ideals/

@thofma thofma added documentation Improvements or additions to documentation triage labels Mar 22, 2025
@fieker
Copy link
Copy Markdown
Contributor

fieker commented Apr 9, 2025

we will do this, by unanimous decision. @thofma will finish it.

@joschmitt joschmitt removed the triage label Apr 9, 2025
@thofma thofma marked this pull request as ready for review April 21, 2025 18:41
@thofma
Copy link
Copy Markdown
Collaborator Author

thofma commented Apr 21, 2025

Added it to all doc pages. Should be good to go if the documentation still builds.

@joschmitt
Copy link
Copy Markdown
Member

This doesn't touch the experimental documentation. Should it?

@lgoettgens
Copy link
Copy Markdown
Member

This doesn't touch the experimental documentation. Should it?

It should do it for all .md files that have a @meta block

@fingolfin
Copy link
Copy Markdown
Member

See also JuliaDocs/Documenter.jl#2512

@thofma
Copy link
Copy Markdown
Collaborator Author

thofma commented Apr 24, 2025

I updated all the files.

(Would of course be great if there were some builtin functionality to do this, but I suggest we don't wait for it.)

@thofma thofma enabled auto-merge (squash) April 24, 2025 17:54
@thofma thofma merged commit 21572f7 into master Apr 24, 2025
32 of 33 checks passed
@thofma thofma deleted the th/testcollaps branch April 24, 2025 18:05
fieker pushed a commit that referenced this pull request May 16, 2025
@lgoettgens lgoettgens changed the title docs: try collapsed docstrings Collapse docstrings in documentation to allow for easier navigation May 19, 2025
@lgoettgens lgoettgens added the release notes: use title For PRs: the title of this PR is suitable for direct use in the release notes label May 19, 2025
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 release notes: use title For PRs: the title of this PR is suitable for direct use in the release notes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants