The best would be to have what Amber does have with Helios: Markdown based documentation, including clickable links.
The fact that Amber runs in a browser is obviously helpful.
Now, nothing prevents a click in the documentation pane to let one go to such a link.�
But �opening a link in a browser is platform dependent.
So, maybe the best bet would be to wait until Pharo gets a new TextModel and leverage that.
This wouldn't solve the non cross platform link open tough.
A temporary fix would be to select a text in the comment pane, right click on it and have an "open in web browser" thing in the menu, leading to whatever is needed to open a link.
Phil