PDF filenames - include release designation ?

Subject: PDF filenames - include release designation ?
From: "Monique Semp" <monique -dot- semp -at- earthlink -dot- net>
To: "TechWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 28 Oct 2015 10:17:13 -0700

Hello, WR-L-ers,

What are people's thoughts about including a software release number in the PDF filename?

I've been requested to do so, and am somewhat resistant to it. But from the Sales team's point of view, it would make it easier for them to send out the correct docs to prospects. (Apparently thereâs a history of sending docs from previous releases.)

But if we indicate the software version in the filename, I'd want to indicate the doc revision too. (Sometimes the docs get revised between releases, so two doc sets per a given release number.) And then where does it stop?!

Are there any âstandard best practicesâ?

(I have to admit the my reluctance is for reasons that arenât actually applicable in the given situation. For example, in repositories, you lose the ability to track changes and updates if you change a filename. But if I go with a structure in the git repo for the FrameMaker files (which are binary and so not amenable to diffs anyway) where I manually create new folders/directories for every release, git tracking wouldnât really be applicable. And if I instead just branch for every release, which is what Iâve been leaning toward, it doesnât matter either if the deliverable PDF filenames, which are generally copies of the default filename inherited from the FrameMaker .book file, are different in every git branch.)

As well, non-dynamic PDF filenames would be important if we were using a doc portal where we could send automated messages upon file updates. But thatâs not applicable.

Thoughts?
-Monique
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

Previous by Author: Win 7 startup manager - recommendations?
Next by Author: Re: PDF filenames - include release designation ?
Previous by Thread: RE: Medical Writing Style Guides and books (references)
Next by Thread: Re: PDF filenames - include release designation ?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads