Return-Path: X-Original-To: apmail-cordova-dev-archive@www.apache.org Delivered-To: apmail-cordova-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 139C118223 for ; Thu, 21 Jan 2016 18:05:18 +0000 (UTC) Received: (qmail 52434 invoked by uid 500); 21 Jan 2016 18:05:17 -0000 Delivered-To: apmail-cordova-dev-archive@cordova.apache.org Received: (qmail 52390 invoked by uid 500); 21 Jan 2016 18:05:17 -0000 Mailing-List: contact dev-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list dev@cordova.apache.org Received: (qmail 52370 invoked by uid 99); 21 Jan 2016 18:05:17 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 21 Jan 2016 18:05:17 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 56DA0DFF94; Thu, 21 Jan 2016 18:05:17 +0000 (UTC) From: riknoll To: dev@cordova.apache.org Reply-To: dev@cordova.apache.org References: In-Reply-To: Subject: [GitHub] cordova-docs pull request: CB-10330 Adding style guide for xml ref... Content-Type: text/plain Message-Id: <20160121180517.56DA0DFF94@git1-us-west.apache.org> Date: Thu, 21 Jan 2016 18:05:17 +0000 (UTC) Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/460#issuecomment-173656844 The content looks good to me, but I had difficulty reading the document. It wasn't clear to me which parts of it are examples and which are the guidelines. The examples are all inline and they include headers, which makes everything a bit confusing because the example appears bigger than the guideline it corresponds to. It would be nice if they could be differentiated in some way (maybe the examples could be put in a "well" like a code block is). --- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastructure@apache.org or file a JIRA ticket with INFRA. --- --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org For additional commands, e-mail: dev-help@cordova.apache.org