Re: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]

Subject: Re: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]
From: Robert Fekete <fekete77 -dot- robert -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 21 Nov 2018 11:58:42 +0100

We have been using git for about 10 years for text-heavy docs (Docbook XML
and Flare HTML) with loads of binary screenshots without any issues.

Robert

On Wed, Nov 21, 2018 at 1:11 AM Mark Giffin <mgiffin -at- earthlink -dot- net> wrote:

> Steve, what is the source format for your docs? Is it something like
> binary FrameMaker files or something? Or is it text files like HTML,
> Markdown, DITA, DocBook, etc?
>
> If your source is text-based and you have some graphics files also,
> there should not be a problem with Git. I recently worked on a large set
> of docs in DITA with quite a few graphics, all stored in Git, and there
> was no problem with the binary graphics files.
>
> In my experience it's about the same with other source control programs
> like Subversion, Perforce, etc: doc source files in text with a few
> graphics files is not a big deal.
>
> But if you are using binary FrameMaker or Word files for doc source, it
> still might work with Git. It seems to me that any source control
> program is going to have the same kind of trouble with a lot of binary
> files. They are designed to work with text files.
>
> Mark Giffin
> Mark Giffin Consulting, Inc.
> http://www.markgiffin.com/
>
> On 20-Nov-18 3:10 PM, Janoff, Steven wrote:
> > Picking up on this thread from Sept.
> >
> > Tony, you'd confirmed what I'd thought about Git causing bloat.
> >
> > What I wonder about though is that Git seems to be gaining ground in the
> Tech Comm industry.
> >
> > I'm sure it's great for API/SDK documents where there's heavy text and
> few images or other binary files.
> >
> > Are we just stuck with it as is, if we have lots of binary files?
> >
> > Thanks,
> >
> > Steve
> >
> >
> > On Wednesday, September 12, 2018 6:49 AM, Tony Chung wrote:
> >
> > Git isnât recommended for binary files because its benefit of storing
> changes only is negated, and bloats the repo for all users. Most FM and
> Word shops I know use SVN or VSS.
> >
> > -Tony
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > Visit TechWhirl for the latest on content technology, content strategy
> and content development | https://techwhirl.com
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > You are currently subscribed to TECHWR-L as mgiffin -at- earthlink -dot- net -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
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | https://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as fekete77 -dot- robert -at- gmail -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
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://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:
Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]: From: Janoff, Steven
Re: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]: From: Mark Giffin

Previous by Author: Re: Visio Guy site down?
Next by Author: Re: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]
Previous by Thread: Re: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]
Next by Thread: Re: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]


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

Sponsored Ads


Sponsored Ads