-
Notifications
You must be signed in to change notification settings - Fork 5.2k
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
8332239: Improve CSS for block tags #19264
Conversation
👋 Welcome back hannesw! A progress list of the required criteria for merging this PR into |
@hns This change now passes all automated pre-integration checks. ℹ️ This project also has non-automated pre-integration requirements. Please see the file CONTRIBUTING.md for details. After integration, the commit message for the final commit will be:
You can use pull request commands such as /summary, /contributor and /issue to adjust it as needed. At the time when this comment was updated there had been 36 new commits pushed to the
As there are no conflicts, your changes will automatically be rebased on top of these commits when integrating. If you prefer to avoid this automatic rebasing, please check the documentation for the /integrate command for further details. ➡️ To integrate this PR with the above commit message to the |
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.
Looks good in a rendered form. However, that mix of CSS units that we have -- %, px, em -- always looked suspicious to me.
Thanks @pavelrappo.
There are reasons for using one or the other.
|
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.
Nice. It works well for short collections of block tags. It works less well for the really long ones,, but it is definitely better than before. Maybe we should still consider other ways of rendering very large block tags. But this is a good first step.
/integrate |
Going to push as commit 44bdf99.
Your commit was automatically rebased without conflicts. |
Please review a change to improve the layout of definition lists used to display block tags:
<dd>
elements used for block tag detailstag-list
ortag-list-long
, which are used for block tags containing lists, such as@see
.Before/after comparison (contains
java.base
andjava.compiler
modules):https://cr.openjdk.org/~hannesw/8332239/api.00/index.html
https://cr.openjdk.org/~hannesw/8332239/api.01/index.html
Comparison for block tag layout:
https://cr.openjdk.org/~hannesw/8332239/api.00/java.base/java/lang/Object.html#hashCode()
https://cr.openjdk.org/~hannesw/8332239/api.01/java.base/java/lang/Object.html#hashCode()
Example of very long block tag details containing a list:
https://cr.openjdk.org/~hannesw/8332239/api.00/java.compiler/javax/lang/model/util/package-summary.html
https://cr.openjdk.org/~hannesw/8332239/api.01/java.compiler/javax/lang/model/util/package-summary.html
Note that the indentation also applies to the definition lists at the top of class/interface documentation as they use the same markup as block tags:
https://cr.openjdk.org/~hannesw/8332239/api.00/java.base/java/lang/Exception.html
https://cr.openjdk.org/~hannesw/8332239/api.01/java.base/java/lang/Exception.html
This was not an intended change but might or might not be desirable. It could be avoided with some additional CSS changes.
Progress
Issue
Reviewers
Reviewing
Using
git
Checkout this PR locally:
$ git fetch https://git.openjdk.org/jdk.git pull/19264/head:pull/19264
$ git checkout pull/19264
Update a local copy of the PR:
$ git checkout pull/19264
$ git pull https://git.openjdk.org/jdk.git pull/19264/head
Using Skara CLI tools
Checkout this PR locally:
$ git pr checkout 19264
View PR using the GUI difftool:
$ git pr show -t 19264
Using diff file
Download this PR as a diff file:
https://git.openjdk.org/jdk/pull/19264.diff
Webrev
Link to Webrev Comment