Re: Customers that make their own docs

Subject: Re: Customers that make their own docs
From: Chris Despopoulos <despopoulos_chriss -at- yahoo -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 3 Mar 2021 08:58:17 +0000 (UTC)

GitHub Wiki is exactly what comes to mind for me. The files are in markdown -- most savvy customers should be able to handle that. It has a mechanism for keeping separate branches for different customers. You could merge your doc updates into their branches, for example. That would take a little coordination to go without any conflicts. But if you can declare certain markdown files off limits to them, then you can merge easily.Â

You can still own the files, and they issue pull requests for you to update their branches on the hub. Then you can merge your changes into their branches, and tell them to pull that back down. The point is, you can review the pull request for any compliance you're worried about. You can also do some formatting to make the WIKI look right.

I'm pretty sure you can get at the individual markdown files. Certainly with GitHub Pages you can. The point here is that if you have a DITA work flow, you should be able to process a book of markdown files into a PDF, and give it whatever branding you want. There might be other markdown-to-PDF solutions out there... I haven't looked into them.
The thing to avoid is a system that tries to erect a silo. AFAIK, Git is pretty good about that.
Visit TechWhirl for the latest on content technology, content strategy and content development |


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 for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @

Previous by Author: Re: Agile Epics & Stories & TechPubs
Next by Author: Re: Interested in input from managers and individual contributors on hiring newbies
Previous by Thread: Re: Customers that make their own docs
Next by Thread: Importing FM or RH Project into Madcap Flare: Pros/Cons?

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

Sponsored Ads