Skip to content

Improve readability of javadoc #3773

Open

Description

@raulvaldoleiros

It would be great if we can read the javado in visual studio editor in an human readable format, instead the code format.

Current Result

Reading documentation in this format is hard.
image

Expected Result

Having a away to read it in an human readable format, in all objects (files in vscode or referenced through maven or gradel)

Additional Informations

If this already exists, sorry and please let me know.

Activity

  1. fbricon commented on Sep 20, 2024

    @fbricon
    Collaborator

    you can hover over the class/field/method the javadoc is bound to

  2. iwangbowen commented on Sep 20, 2024

    @iwangbowen

    Much needed

  3. raulvaldoleiros commented on Sep 20, 2024

    @raulvaldoleiros
    Author

    you can hover over the class/field/method the javadoc is bound to

    Hi @fbricon , thanks for the suggestion.
    You are right, but my use case is a little bit different if I got it correctly. I'm opening classes that extends an interface and trying to read the documentation to understand what they do. I'm opening the javadoc web page to read it the documentation and it would be much better in vscode.

  4. fbricon commented on Sep 20, 2024

    @fbricon
    Collaborator

    I understand, I was merely suggesting a workaround. I know Jetbrains IDEA as a nice way of showing human-readable javadoc instead of raw html. But I'm not sure if VS Code is capable of doing something similar

    Screenshot 2024-09-20 at 15 27 24 Screenshot 2024-09-20 at 15 27 32

    @testforstephen @aeschli any idea?

    Worst case scenario, we could probably add a command to open a javadoc view

  5. rgrunber commented on Sep 23, 2024

    @rgrunber
    Member

    Could we collapse/fold the Javadoc node (server-side AST would give us this) and insert the "rendered" Javadoc as a code lens / inlay hint ?

  6. AsyncK278 commented on Sep 26, 2024

    @AsyncK278

    we really need this feature

  7. nerfi58 commented on Dec 20, 2025

    @nerfi58

    Any updates on this?

  8. fbricon commented on Jan 14, 2026

    @fbricon
    Collaborator

    javadoc-tools has a JavaDoc Preview view, you can move around:

    Image
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions