In my previous blog posts on document revision control, I talked about the importance of managing document revisions and creating standard directory structures, and tracking changes to documents. In this blog post, I'll explain why it's important to have standard document part numbers and file naming conventions, and provide some guidelines.
Establishing a naming convention for both the document part number and the file name is an important component of a document revision control process. Without a standard document part number system, it can be hard to track files and find files, and it can cause confusion with customers. If your business is trying to meet ISO 9001 standards, you will have to establish a document revision control process, of which naming conventions are a part. File names will be visible to customers when they download documents so you want to have something that makes sense to them.
Document Part Number Convention Guidelines
You need to have a document part number convention so that each document has its own unique identifier. The document number should be clear and easy to find because you don't want to cause any confusion. Some businesses have a configuration management system in which the part numbers are automatically assigned. However, if you don't have this system, you have the freedom to create your own numbering conventions.
Think about the elements of a part number that make sense for your business, and if you translate your documents, make sure your naming convention also makes sense for the various languages. I suggest following these guidelines:
- Consider whether the documents are internal, external or both, and if they should follow the same or different numbering conventions.
- Look at how many documents are in the document set and make sure you have a system that will allow you to expand that document set. For example, right now you may have 40 customer success stories, but you want to make sure you can grow the amount so you don't want to use a 2-digit numbering system. With technical documents, especially if you translate them, you might have hundreds or thousands of them so your part number should be at least four digits long.
- If you're creating a numbering convention for a relatively simple document set, you could add a prefix to the part number so that you can quickly identify a document. For example, if you have a white paper document set, you could start the numbering with the prefix "WP." So a full document number might be something like "WP-000139." You could also include some of the key words in the title of the white paper such as "WP-000139 Product ABC Can Do X."
- However, if you have a more complex document set, such as technical documentation, you may have quite a few identifiers that you could incorporate into the part number. For example, you could add some elements to reflect the document type, product name, language, version or release date. Here are some examples:
For version control purposes, you need to make sure you have a revision level (number or letter) for each document. Every time you revise the document, the revision number or letter should move forward by one. Here are some examples:
Implementing a revision level is a critical component of version control. With this, each document will have its own part number and revision letter, making it a unique document. If you translate your documents, it's important to sync the translations with the English revision level so you know the contents are the same.
Here are a few more things to consider:
- The location of the part number should be easy to find on the document, such as on the cover.
- In addition to the part number and revision level, the month and year should also be in an easily identifiable location, preferably by the part number. A customer may not know that the "B" in the part number is the revision level, but a month and date are easy to recognize.
- If you translate your documents, follow the same process for the translated documents.
File Naming Convention Guidelines
In addition to document part number conventions, you also need a document file naming system. You can follow the same guidelines I presented in the previous section.
There are two additional things to consider when naming files. First, your file name might change based on how it works with your website. For example, you may give your file a specific name, but your website names files based on an automated, random numbering scheme. Before you do too much work, talk to your website experts to see if this might be an issue. Second, think about what your customers would want to see when they download your file. You may want to use an elaborate naming system because it helps internally, but a customer may not have any idea what TD11456-BC_9.01_ABC_Sept2015 means. Keep this in mind as you create your file naming conventions.
Some authoring programs like Adobe Acrobat and FrameMaker have built-in properties fields which you can use to track things like the title, author, subject and keywords. These can be important fields to fill out for version control; to make the document more findable, both by your website search and search engines; and for search engine optimization. If your documents are translated, work with your language service provider to develop a process for the translated documents.
It's important to establish a standard naming convention for both the document part number and the file name. There are many different elements to consider in your naming conventions; and the document part number should be in an easily-identifiable location. Look for future blog posts from me on revision control.
Resources for Content Strategy
You may gain further insight into content strategy, document localization, translations and related topics by reviewing previous blogs written by GPI:
- Document Revision Control Part 1: Managing Revisions and Creating Standard Directory Structures
- Document Revision Control Part 2: Tracking Changes between Revisions
- Content Strategy Part 1: Content Audits
- Content Audits Part 2: Technical Content Audits
- Content Audits Part 3: Marketing Collateral Audits
- Content Audits Part 4: Web Content Audits
- Content Strategy: Auditing for Localization
GPI's content strategists and localization specialists can help analyze your website and provide guidance on any localization and global digital marketing requirements. GPI also offers Global Search Engine Marketing Services and many other Translation Services.
About the Author
Daniela has over 16 years experience in the translation, localization and language instruction professions. She holds a degree in Sworn, Literary, Technical, and Scientific Translation from the Instituto Nacional de Enseñanza Superior Olga Cossettini in Rosario, Argentina. Starting her career as a translator for English-Spanish/Spanish-English in 1990 over the years she has worked for several Localization Agencies as a translator, assistant project manager and senior project manager. She has completed a wide range of professional certifications in document and website localization with emphasis on translation, budgeting, quality control and project management including The Localization Institute’s Triple Certification in Localization Project Management (Localization Institute Chico, CA, USA).More Content by Daniela Bustamante