It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Anchor macros randomly break.

Eric Riddle Jun 27, 2012

Hi. We're in the process of inserting anchors within our documentation and we're finding that the anchors are randomly breaking and renamed.

For example, we create an achor called Requirements

Later, when testing, we find that links to that anchor have been renamed to Requi. We fixed it, and later we found it called Requ.


Of course, any link within the document that links to #Requirements is now broken.

Any ideas?

Edit: Update with clarification:

The anchor names remain the same. It's the links that get renamed.

For example, I might have text that says "check the requirements section" and the link is to #requirements.

Later I check and the text is the same, but the link is now #requi and doesn't jump to the anchor.

5 answers

0 votes
Eric Riddle Jun 27, 2012

Matthew, I'm sorry I wasn't clear.

The anchor names remain the same. It's the links that get renamed.

For example, I might have text that says "check the requirements section" and the link is to #requirements.

Later I check and the text is the same, but the link is now #requi and doesn't jump to the anchor.

0 votes
Matthew J. Horn Jun 27, 2012

When you say it has been renamed, do you mean the actual <a> (anchor) tag within the page has been "renamed" or the text in the link to that anchor tag has been "renamed".

0 votes
Matthew J. Horn Jun 27, 2012

Huh, I use a lot of local anchors and haven't seen this before. I can't think of why it might be happening. Can you reproduce this, or is it fairly random? I'd say if it's reproducible, you should file a bug. If not, hopefully, someone else can chime in and suggest what might be happening.

0 votes
Eric Riddle Jun 27, 2012

It's fairly random. Me (and my documentation team) just noticed it this morning. I haven't found a way to reliably reproduce it.

Our workflow right now is focused on adding links, anchors, and cross-referencing articles. So we're going through articles and adding this, then we check each others' work. We fixed links, but now we're finding links that we /know/ we fixed broken again.

0 votes
Matthew J. Horn Jun 27, 2012

I guess one thing I would do to diagnose would be to look at the history of the page and diff the page with the previous to see when the change occurs. Not sure if this is going to lead to anything, but at least there's a chance that a pattern will emerge.

Suggest an answer

Log in or Sign up to answer
This widget could not be displayed.
This widget could not be displayed.
Community showcase
Published in Confluence

6 Awesome Ways to Apply Trello, JIRA and Confluence to your Project

I attended  Atlassian Summit 2019  and learned a lot from the presenters, attendees and knowledgeable Atlassian product managers. The presentations I attended focused on applying Agile, pla...

2,528 views 11 28
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you