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 BAB1E1120A for ; Thu, 21 Aug 2014 02:00:27 +0000 (UTC) Received: (qmail 95805 invoked by uid 500); 21 Aug 2014 02:00:27 -0000 Delivered-To: apmail-cordova-dev-archive@cordova.apache.org Received: (qmail 95778 invoked by uid 500); 21 Aug 2014 02:00:27 -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 95765 invoked by uid 99); 21 Aug 2014 02:00:26 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 21 Aug 2014 02:00:26 +0000 X-ASF-Spam-Status: No, hits=1.7 required=5.0 tests=FREEMAIL_ENVFROM_END_DIGIT,HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of csantana23@gmail.com designates 74.125.82.175 as permitted sender) Received: from [74.125.82.175] (HELO mail-we0-f175.google.com) (74.125.82.175) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 21 Aug 2014 01:59:59 +0000 Received: by mail-we0-f175.google.com with SMTP id t60so8730340wes.34 for ; Wed, 20 Aug 2014 18:59:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=zxrdGS7LS4+Bez08DrUnEje2QNWigM2dvaNnEZNAelg=; b=Ef0/ih98ygbvvdHuHoY77KyaOKU4RzfeBpaAWrMtTBdOInvmqiwO7/VgW3hiGMFKsS 7Ka85eL09Uxxf42aPRaENPEY46KiB8LFUH9G5tjS5Ws0XE4/PEf4SoGTO3uIK9DMlKWg 0DBFT5ftFdH2jJ0eK9bOKL+cYEImZkioYbp2P9MJ4JNTJ4fPLxbA20aRq64JbO/Fzk5U uPo/ToxSLvxJyLerw1fVkNfQ81Ghqnax9btW9T9gmqLLGzGuPP2JEgtCAvopEHu+a+0M 5Ej1/iP80sr39BJ2YymqfbDrlO3TEF/nL3c6vnq5+p4o0v1LG5qJ8npMk1FwNI4yI2CF yM0A== MIME-Version: 1.0 X-Received: by 10.180.80.133 with SMTP id r5mr19334109wix.62.1408586398646; Wed, 20 Aug 2014 18:59:58 -0700 (PDT) Received: by 10.194.109.201 with HTTP; Wed, 20 Aug 2014 18:59:58 -0700 (PDT) In-Reply-To: <1408582699338.34807@adobe.com> References: <20140728094156.GA53511@gmail.com> <1408569429893.54494@adobe.com> <1408582699338.34807@adobe.com> Date: Wed, 20 Aug 2014 21:59:58 -0400 Message-ID: Subject: Re: What's Stopping us From Independent Platform Releases From: Carlos Santana To: "dev@cordova.apache.org" Content-Type: multipart/alternative; boundary=f46d044403a2ed470405011a136b X-Virus-Checked: Checked by ClamAV on apache.org --f46d044403a2ed470405011a136b Content-Type: text/plain; charset=UTF-8 Yes Ray, that's what I meant as a new Design for the Docs website. To be a consolidated simple view of the docs, but the real docs will be associated with each component as an implementation detail. It can also be a consolidated view of docs as utility of the cordova CLI, for example "$cordova docs" launches a local web server, open the browser, and serves a local website with the content coming form the versions of the things being used in your cordova project/folder (ios, plugin1, plugin2) We need to try different things, get feedback and iterate And feedback from coming form developers such as yourself. --Carlos On Wed, Aug 20, 2014 at 8:58 PM, Ray Camden wrote: > Keep in mind - the average developer probably has no idea what > cordova-ios, cordova-cli, and cordova-lib means. They npm install cordova, > and to them, that's it. > ________________________________________ > From: Carlos Santana > Sent: Wednesday, August 20, 2014 7:54 PM > To: dev@cordova.apache.org > Subject: Re: What's Stopping us From Independent Platform Releases > > I think we need to come down to the same conclusion as we did for plugins. > The documentation for each "component" meaning "cordova-ios", > "cordova-cli", "cordova-lib" needs to live with it's repo/code and version > together. > > The remaining things can be left in cordova-docs that are independent of a > version of a component to an extent like security guide. > > The Cordova Docs Website will need to have a new UX design to make sense of > where links point and somehow allow the user know what's the latest release > and the different components with each respective version. > > > -- Carlos Santana --f46d044403a2ed470405011a136b--