Hi,

I write use case documents in the rich text editor of the use case artifact.
When I drag and drop actors from the project explorer content page into the use case document I get a perfect reference link to the actor in my document.

The problem is when I change the name of the actor artifact the link text in the use case document is never updated. That is a problem when refactoring some artifact names referenced in many other document. All the documents have to be updated by hand.

The other way round is to use the technique "Insert Artifact..." in the context menu of the rich text editor. In this case the whole artifact is inserted - including all the documentation which can be very long. So the use case document containing the whole description of every actor is useless either. But the benefit in this case is that changing the actor name in the actor artifact also changes the occurrence of the actor name in the use case document. So no manual updates would be necessary.

So because I know only this two ways to make references to artifact in documents I have no way to get consistent documents right now. Is there a better way to do it?