-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Scaladoc - add option for dynamic side menu #19337
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
Conversation
|
to rephrase the linked issue, this is very important for large code bases to avoid enormous file sizes |
|
Did you check it on various browsers? |
|
Yes, works fine in Chrome, Firefox, Safari. |
| defaultTemplate: Option[String] = None, | ||
| quickLinks: List[QuickLink] = List.empty | ||
| quickLinks: List[QuickLink] = List.empty, | ||
| dynamicSideMenu: Boolean = false, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it should be dynamic as a default for now (so the default behavior doesn't change). We can change it to default after we ensure it works in practice.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
false is the old behavior
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oh, right, this one if confused me. So everything looks alright!
szymon-rd
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Everything looks good, just one comment about keeping the old one as default for some time.
|
Also fixes #19371 |
|
I recon scala/docs.scala-lang#2942 should be merged after new Scala version with those changes is released to avoid confusion about new option not working. |
|
@Florian3k Yes |
Backports #19337 to the LTS branch. PR submitted by the release tooling. [skip ci]
Closes #18543
This PR adds
-dynamic-side-menuoption to Scaladoc.With this option Scaladoc doesn't generate side menu (packages etc. tree) in html files. Instead it is serialized into .json file and rendered on the client using Javascript.