Re: Developments in the review cycle

Subject: Re: Developments in the review cycle
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 6 Apr 2016 14:48:04 -0700

I think we're planning to migrate to Bitbucket, which I believe can do
the same thing.

Switching from XHTML source in Confluence to Markdown in files seems
like rolling back the clock five years, unless there's a wiki that
uses Markdown source. And even then, Prince is way more expensive than
Scroll PDF Exporter.

On Wed, Apr 6, 2016 at 1:25 PM, Ryan Young <ryangyoung -at- gmail -dot- com> wrote:
> We're using a private GitHub repo, which is a sub-tree of a public repo. You
> might want to check it out, actually:
> https://github.com/ripple/ripple-dev-portal
>
> My co-worker is a pretty brilliant developer who created a tool that parses
> Markdown into HTML and PDF (through Prince), so we can single-source from
> those repos with different targets defined in a .yml config file. The PDF
> part is what's allowing us to move away from Confluence.
>
> On Wed, Apr 6, 2016 at 1:05 PM, Robert Lauriston <robert -at- lauriston -dot- com>
> wrote:
>>
>> Is that just basic Git or are you using Bitbucket or GitHub?
>>
>> On Wed, Apr 6, 2016 at 12:58 PM, Ryan Young <ryangyoung -at- gmail -dot- com> wrote:
>> > We've started using pull requests in Git for our reviews (our source is
>> > Markdown). Like Confluence, everyone can see each other's comments and
>> > you
>> > can have a conversation thread. It works especially well for revisions
>> > because you can see exactly what changed. It hasn't been that long, but
>> > I've begun to prefer it to Confluence because it limits comments to the
>> > review period. ...
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://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:
Developments in the review cycle: From: Erika Yanovich
RE: Developments in the review cycle: From: Steve Hudson
Re: Developments in the review cycle: From: Ryan Young
Re: Developments in the review cycle: From: Robert Lauriston
Re: Developments in the review cycle: From: Ryan Young

Previous by Author: Re: Developments in the review cycle
Next by Author: Re: Developments in the review cycle
Previous by Thread: Re: Developments in the review cycle
Next by Thread: Re: Developments in the review cycle


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

Sponsored Ads


Sponsored Ads