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: Jody Zolli <jody -dot- zolli -at- gmail -dot- com>
To: fekete77 -dot- robert -at- gmail -dot- com
Date: Wed, 21 Nov 2018 07:26:43 -0500

How do you handle file locking with git, if you have multiple writers
working simultaneously with the same book / files?

-Jody

On Wed, Nov 21, 2018 at 5:58 AM Robert Fekete <fekete77 -dot- robert -at- gmail -dot- com>
wrote:

> 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 jody -dot- zolli -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
Re: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]: From: Robert Fekete

Previous by Author: RE: Git for Tech Pubs [was FW: L@@king for recommendations for a doc source-file management system....]
Next by Author: Re: "Preferring technical acuity over specialized knowledge"
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