[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

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: Mark Giffin <mgiffin -at- earthlink -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 21 Nov 2018 09:51:32 -0800

You don't lock files in git. It's a different philosophy of source control. With git the focus is on merging when there are conflicts, or using "rebase" or other methods. If you have lots of people working on the same file at the same time, you might be able to make it work in git, but you might want to just stick with something where you can lock files, like Subversion. Or refactor your files so you are not all working on the same file at once. (Many working on the same file at once does not sound like a best practice.)

I'm assuming you're using a text-based format. But if you're using something like binary FrameMaker files, you probably need to lock files. You can't merge binary files.

Mark Giffin
Mark Giffin Consulting, Inc.
http://www.markgiffin.com/


On 21-Nov-18 4:26 AM, Jody Zolli wrote:

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

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: Git for Tech Pubs [was FW: L@@king for recommendations
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....]

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

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

Sponsored Ads