Intra-document Links in Docx don't Work

Sometimes, the links that point to topics inside the document don't work in generated docx. When you click the link, you'll be redirected to the start of the document.

VSdocman assigns a bookmark to each topic. A link to a topic is then created as a cross-reference to such a bookmark. A bookmark name is generated from a member name using File Names settings. If you use default Numeric file names, the bookmark name will have a short numeric form. You can see it when you hover over the link.



If you, however, use Pretty file names, the bookmark name will be constructed from code member's full name and this can lead to a quite long bookmark name.



But MS Word has a limit of 40 characters for bookmark names. If you exceed that limit, you'll get the behavior described above.

Solution

Always use  Numeric file names when you generate docx format.

 

Start generating your .NET documentation now!
DOWNLOAD
Free, fully functional trial
VSdocman Tip
Use <see langword="null"/> when you refer to null or Nothing in your comments. There are special tags also for other keywords such as true, false, abstract, etc.
Customers

Universities
Medical institutions
Government institutions
Large financial institutions
Thousands of SW companies

Deloitte & Touche
PricewaterhouseCoopers
Bloomberg
Wells Fargo
QBE

Caterpillar
Lear
DuPont
Pfizer

Boeing
Airbus
Rolls-Royce Naval Marine
Toyota Motorsport

Bose
Mitsubishi Electric
Johnson Controls
Bentley Systems

Intel
Hewlett Packard
Bosch (Australia)
Schneider Electric

Intergraph
Volvo Information Technology
SOPRA GROUP
Agilent Technologies
Tesco SW

Syncfusion
T-Systems
Verizon
Fraunhofer Heinrich-Hertz-Institut

vs launch partner logo

VS Mag award VS Mag award

I have been using VSdocman to provide C# .NET API integrated documentation for our customers for the past 7 years. Keeping up with Microsoft's Visual Studio version changes can be challenging for developers, but VSdocman has continued to provide excellent functionality that meet our requirements to satisfy internal and external users. This company also provides immediate excellent customer support when issues or confusion occur.

Edna Turner Stilwell, Staff Writer/.NET Lead