Re: PDF filenames - include release designation ?

Subject: Re: PDF filenames - include release designation ?
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: TechWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 28 Oct 2015 18:36:57 +0100

That seems essential to me when various customers are using various
releases. Otherwise it's easy for people to get confused by consulting
the wrong version of the docs. (If everyone is always on the current
release, as is typical with SaaS apps, the issues are different.)

In my last job I used FrameMaker and would rename the book file for
each release.

Generated files usually don't belong in source control.

On Wed, Oct 28, 2015 at 6:17 PM, Monique Semp
<monique -dot- semp -at- earthlink -dot- net> wrote:
> 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.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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:

References:
PDF filenames - include release designation ?: From: Monique Semp

Previous by Author: Re: Post about a creative writer who went into tech writing for a spell
Next by Author: Re: [Framers] Heading Question
Previous by Thread: PDF filenames - include release designation ?
Next by Thread: Re: PDF filenames - include release designation ?


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

Sponsored Ads


Sponsored Ads