doc: fix some minor issues (links, name, add `<kbd>` tag, ...)

[The-Lum]

• [x] fix README link to docs
• [x] rename Alice and Bob to First example: "Alice and Bob"
• [x] add Import/Export link
• [x] add <kbd> tag on Ctrl+S

[FYI @HeinrichAD]

[HeinrichAD]

LGTM.

Nice catches. Good to know that somebody is reading/using the documentation (or at least want to) :+1:.

To be honest, I expected that you added <kbd> also inside the settings. But I just saw that I didn't document that Ctrl+, or Meta+, is also opening the settings :sweat_smile:. Maybe I will add it next time or if you want you can also add it.

[The-Lum]

@HeinrichAD:

Maybe I will add it next time or if you want you can also add it.

That is done with #295.

Thanks for all your work of all the PlantUML WebUI, it seems now very good, and not as old school as before...

It might be interesting now to see what new other improvement would be nice... (a comparison of all the servers in place would perhaps be necessary to help in our choices.) [Maybe I can help with this]

Regards.

[HeinrichAD]

@The-Lum

That is done with https://github.com/plantuml/plantuml-server/pull/295.

Thanks. I already saw it and added a small question out of curiosity. Nothing that need to be changed.

Thanks for all your work of all the PlantUML WebUI, it seems now very good, and not as old school as before...

Glad to hear. Especially since I'm not a UI expert. We will see if there new issues w.r.t. the UI will be raised in the near future.

It might be interesting now to see what new other improvement would be nice...

Naturally, their are a few things that could be done. For example:

• As I wrote here the editor currently uses apex as language for syntax highlighting and code completion. It would be nice to have a plantuml language file.
• there are some language features which could be easily added. Just have a look at the result of the language servlet or the output of java -jar plantuml.jar -language
• I also though about an API documentation (OpenAPI) to have an overview what plantuml-srever is capable of (and how). Also startet to implement that. If i find time I will create a PR
• You could thing about how to improve the unit tests. There was an idea to check at least a few rendered diagram images not only by response and size but also by it similarity with previous generated diagram. For example with structural similarity index measure (SSIM) or something similar.
• Edit: It would also be great to have one parent pom with includes everything which is in both pom identical (properties, plugin, reports, ...). In this case (1) the differences you be much easier to detect, and much more important (2) only the parent pom have to be updated in the most cases (e.g. if there is a new plantuml version). Let's just say maintaining would be much easier and less sensitive to mistakes.

But before starting new things I would propose to re-evaluate the open issues first. I briefly check them and noticed that 50% of the open issues are already solved/answered, can't be reproduce anymore or are no longer relevant. Additionally, there are many issues which could be answered quite quickly, somebody just need to reproduce and test them or just require some more documentation. Finally, one could try to solve the reminding open issues :smile:. A few interesting issues are definitely getting lost in the crowd at the moment. The same applies to the 3 remaining pull requests as to the issues (re-evaluation).

But to be honest that is my opinion. Other people might feel differently.