logo

NJP

Six Tips for Useful URLs in Your Knowledge Base Articles

Import · Jul 31, 2018 · article

This is the fourth in a series of suggested practices for creating knowledge base content.

Your knowledge base content is even more helpful if it includes links to other helpful content. Note these tips for constructing and formatting external and sample links:

There's No "Here" Here

imageUse the target title for your link text rather than generic words like "here" or "click".

Not helpful: "For more information, click here."

More helpful: For more information, see Constructing Useful Links.

Lose the URL

Don't use the URL as the link text – use the target title text instead so people know the subject of where they're headed.

Set the Context

Let people know if they're leaving your site to go to an external location. For bonus points, let them know what type of information the link provides, for example, a documentation topic, an article, a PDF file, and the like.

Use Variables in Sample URLs

When providing a sample URL, use variables rather than internal server or employee names.

For example, https//:.example.com/dev/.

View original source

https://www.servicenow.com/community/in-other-news/six-tips-for-useful-urls-in-your-knowledge-base-articles/ba-p/2273828