From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 51C7F2095D2C1 for ; Mon, 10 Jul 2017 13:37:16 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id E982F77350; Mon, 10 Jul 2017 20:39:00 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com E982F77350 Authentication-Results: ext-mx03.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx03.extmail.prod.ext.phx2.redhat.com; spf=pass smtp.mailfrom=lersek@redhat.com DKIM-Filter: OpenDKIM Filter v2.11.0 mx1.redhat.com E982F77350 Received: from lacos-laptop-7.usersys.redhat.com (ovpn-116-146.phx2.redhat.com [10.3.116.146]) by smtp.corp.redhat.com (Postfix) with ESMTP id 59F915DC1D; Mon, 10 Jul 2017 20:39:00 +0000 (UTC) To: "Kinney, Michael D" Cc: "edk2-devel@lists.01.org" References: <641e085b-2797-cc7f-fd0b-97a685c7725c@redhat.com> From: Laszlo Ersek Message-ID: <6d43e2dd-d795-3a84-0f15-9683e43d3bb6@redhat.com> Date: Mon, 10 Jul 2017 22:38:59 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.2.1 MIME-Version: 1.0 In-Reply-To: X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.27]); Mon, 10 Jul 2017 20:39:01 +0000 (UTC) Subject: Re: TianoCore-docs GitBook Documentation Process X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Jul 2017 20:37:16 -0000 Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit 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 , 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