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

[Robert Fekete <fekete77 -dot- robert -at- gmail -dot- com>]

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