This is probably not easy task or fast to resolve, but take it as open discussion and lets see what comes from it.
In these days of cool looking engines VP produced content still looks like plain old javadoc. Its simple as it.
There are multiple aspects which I will target one by one with some example of how it might look more attractive:
There should be something similar like the Model explorer tree view and interactive search (I write, it automatically filters)
- Graphical layout
One of the very nice example of how to produce high quality docs is read-the-docs.
- Support of code highlight, custom pages (non-diagram), etc.
Maybe markdown language support will be good, source code highlighting.
- Doc composer
When I click generate data documentation on logical diagram context menu, what comes out looks like this:
I don’t know, but this is not how documentation might looks
Overall it feels like I am still 10-15 years back when browsing HTML docs… Maybe its just my own feeling, let me know what you think in general and maybe we can discuss here future look of the docs.
What other thinks?