Re: TianoCore-docs GitBook Documentation Process

[Laszlo Ersek <lersek@redhat.com>]

Hello Mike,

On 07/10/17 18:43, Kinney, Michael D wrote:
> Hi Laszlo,
> 
> Thanks for the quick feedback on this content.
> 
> Reponses included below, and I have already made some
> updates to the wiki based on your feedback.

thank you for the answers, they are very helpful. I'll highlight one thing:

> The GitBook
> integration with GitHub is actually a bidirectional sync, so I found
> it confusing to do edits from both sides.  Also, an edit from the
> GitBook side does not follow the TianoCore patch/review process.

I did not miss the bidirectional arrow :) in the top diagram of
<https://github.com/tianocore-docs/edk2-TemplateSpecification/wiki/TianoCore-Documents-GitBook-Overview>,
between "GitHub tianocore-docs" and "GitBook tianocore-docs". I was
wondering if the left-pointing arrow was an oversight :)

So apparently it's not. We'll have to be careful to avoid WYSIWYG
editing on GitBook.com (personally I'd like to avoid that even for my
forks too). I guess one way to stay safe is to remain logged out of the
GitHub & GitBook websites most of the time (which is how I've been
operating anyway).

Thanks!
Laszlo