That makes sense Justin. I'm open to alternative solutions as well - hopefully whatever we do, it is easy for users to understand.
An example of an alternative solution would be a link listed at the top of each page with the direct URL to that page. Art On Mon, Feb 24, 2025 at 10:58 PM Justin Bertram <jbert...@apache.org> wrote: > > Can we update the site to show the URL to which the user navigated? > > I would certainly be open to such a change. > > Just to be clear, the current design is a bit of a compromise due to the > nature of the ActiveMQ Artemis. You might not realize this, but the Artemis > docs are generated from AsciiDoc and uploaded to the website during the > release process. When these docs were originally integrated into the > website it was not clear how to make it seamless. Currently they are put > into a "frame" where logo and menu items which are visible across the rest > of the website are still present. The idea was to maintain continuity > between the overall ActiveMQ website and the Artemis docs. However, the > cost of that continuity is that the URL in the browser's address bar > doesn't change when navigating the docs. > > That said, it is possible to right click on any of the links in the table > of contents or indeed any sub-headings throughout any of the chapters and > copy a link directly to that bit of documentation. I've used this many > times to point users to the specific bit of documentation which is relevant > to their needs. I've personally worked to ensure the docs are as linkable > as possible. > > AsciiDoc is pretty powerful so we may be able to get the best of both > worlds (e.g. seamless integration without frame nonsense). I'm open to > ideas on how to accomplish that. > > > Justin > > On Mon, Feb 24, 2025 at 3:53 PM Arthur Naseef <artnas...@apache.org> > wrote: > > > I recently used the Artemis documents here: > > https://activemq.apache.org/components/artemis/documentation > > > > And noticed that, upon navigating to a specific page, the broker still > > shows this fixed URL. This is problematic for sharing specific content > > from the site. > > > > Can we update the site to show the URL to which the user navigated? > > > > Art > > >
