Harry Miller's Technical Writing Blog

Mostly podcasts about documentation, technical writing, and technical editing.

Tokens

Tokens are markers that we can use in the documentation to represent product and feature names that might change, and reusable text that we don't want to type manually in a bunch of topics. When the build team converts the XML source files into the final compiled Help, they pull the token's replacement value from a separate file. Any changes to the text or product name are made in only one place, and they appear in all the appropriate topics.

We're looking at how to expand our use of tokens in the next writing cycle. I talked with Arwyn Carroll, a technical editor on the Windows Server team, about how they have been using tokens.

This podcast is 2.59 MB in size, and 5 minutes, 39 seconds long.

Download the podcast

Published Monday, June 19, 2006 12:28 PM by HarryMiller

Comment Notification

If you would like to receive an email when updates are made to this post, please register here

Subscribe to this post's comments using RSS

Comments

No Comments

Leave a Comment

(required) 
(optional)
(required) 
Submit

This Blog

Syndication

Tags

No tags have been created or used yet.

News

All postings are provided "AS IS" with no warranties, and confer no rights. This site contains my personal opinions. These opinions do not represent my employer's view in any way. Also, I'll probably change my mind at some point.

© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Microsoft
Page view tracker