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 37F4E10123 for ; Fri, 20 Dec 2013 19:16:31 +0000 (UTC) Received: (qmail 26457 invoked by uid 500); 20 Dec 2013 19:16:30 -0000 Delivered-To: apmail-cordova-dev-archive@cordova.apache.org Received: (qmail 26430 invoked by uid 500); 20 Dec 2013 19:16:30 -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 26417 invoked by uid 99); 20 Dec 2013 19:16:30 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 20 Dec 2013 19:16:30 +0000 X-ASF-Spam-Status: No, hits=1.5 required=5.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of brian.leroux@gmail.com designates 209.85.223.176 as permitted sender) Received: from [209.85.223.176] (HELO mail-ie0-f176.google.com) (209.85.223.176) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 20 Dec 2013 19:16:25 +0000 Received: by mail-ie0-f176.google.com with SMTP id at1so3592079iec.35 for ; Fri, 20 Dec 2013 11:16:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:content-type; bh=Weiv5Vqp0s5/48fEQHe9Vc4wvADSKcWqH05edGlUQJw=; b=0+J0IY8tQHnOs1DcehyKVyXiWH/m8iFBySiT0l/nYBUxC40LDyZMv4t7Ae2Ih6AiaO QhhnkSvYG3N1p7bv8Xht9hEREF6wsQFgj/Ovqh9++wI7iIURHRVe9cjZ0vH6bWqXMpgv b2uhMO6w3fYAONuL7zeSB/BqnISc0HZCYdHuKgmhoENYRMRzjuqojP9noAodkw18lpNk PoKyIFsMYiDd+GxFzovkW1XJQj4goD4OtRSI6bk8yumpqsHW65AiMYE7IOn3c2rOL6uP XDGpvUYFgILZbI/tQxC5gfCFXT3jLbcGCB/2wWkermA9YKA/SVqZufoUocFC9gnopvmT 0row== MIME-Version: 1.0 X-Received: by 10.50.128.72 with SMTP id nm8mr9560882igb.10.1387566964127; Fri, 20 Dec 2013 11:16:04 -0800 (PST) Sender: brian.leroux@gmail.com Received: by 10.50.114.132 with HTTP; Fri, 20 Dec 2013 11:16:03 -0800 (PST) Received: by 10.50.114.132 with HTTP; Fri, 20 Dec 2013 11:16:03 -0800 (PST) In-Reply-To: References: <52EFFE29-B85B-4C3E-BB2F-15CD4D415CC1@gmail.com> <5900F9BCB827854FB01CA94BA718810D367C20C1@USPHLEMB11A.global.corp.sap> Date: Sat, 21 Dec 2013 05:16:03 +1000 X-Google-Sender-Auth: N9RfcTqL_NZXvDpqj7GgnkV0kvo Message-ID: Subject: Re: Deleting Plugin Docs From: Brian LeRoux To: dev@cordova.apache.org Content-Type: multipart/alternative; boundary=089e013c5af0ffc0cb04edfc1bdb X-Virus-Checked: Checked by ClamAV on apache.org --089e013c5af0ffc0cb04edfc1bdb Content-Type: text/plain; charset=ISO-8859-1 Agreed, that is a goal. Mike is looking at Docs, Joni/Steve/Anis Plugins, and we can refresh WWW last. On Dec 21, 2013 3:05 AM, "Carlos Santana" wrote: > Forgot to mentioned consistency look and feel (i.e. CSS) between the > *three*primary websites ! > > www.cordova.io > docs.cordova.io > plugins.cordova.io > > > > On Fri, Dec 20, 2013 at 11:52 AM, Carlos Santana >wrote: > > > All docs for Cordova CLI, Plugman CLI, and Platforms hosted/rendered on > > docs.cordova.io > > and > > All docs for Plugins hosted/rendered on plugins.cordova.io > > > > If this is true, I would like to see consistencies on look and feel of > > both websites, and ability to link back and forth between sites via > links. > > > > > > > > > > On Fri, Dec 20, 2013 at 11:42 AM, Andrew Grieve >wrote: > > > >> The eventual goal (in my eyes) is to have plugin docs: > >> 1. Appear with the plugins on plugins.cordova.io. > >> 2. Be accessible to devs after they have installed the plugin (e.g. by > >> looking at plugins/foo/doc, or maybe by having "cordova serve" show > them) > >> > >> > >> > >> > >> On Fri, Dec 20, 2013 at 11:38 AM, Carlos Santana >> >wrote: > >> > >> > I'm a bit lost > >> > > >> > Is the eventual goal to build the docs as a single website ( > >> > docs.cordova.io) > >> > with multiple repos cordova-docs repo and plugin repos? > >> > > >> > > >> > > >> > On Fri, Dec 20, 2013 at 11:00 AM, Wargo, John > >> wrote: > >> > > >> > > Andrew, > >> > > > >> > > Will you be processing the plugin docs so they generate the pages > like > >> > > they used to? Being able to click and link around within a > particular > >> > > plugin's doc is super helpful. > >> > > > >> > > John M. Wargo > >> > > Twitter: @johnwargo > >> > > > >> > > > >> > > -----Original Message----- > >> > > From: agrieve@google.com [mailto:agrieve@google.com] On Behalf Of > >> Andrew > >> > > Grieve > >> > > Sent: Wednesday, December 18, 2013 10:40 PM > >> > > To: dev > >> > > Subject: Fwd: Deleting Plugin Docs > >> > > > >> > > This is now done! Woo! No more having plugins code separate from > their > >> > docs > >> > > (I hear we might even get tests to live within plugin repos in the > >> next > >> > > while too!). > >> > > > >> > > I tried to be diligent, but it's possible I made mistakes along the > >> way. > >> > > You can see the result on the edge version of the docs: > >> > > http://cordova.apache.org/docs/en/edge/ > >> > > > >> > > There's a new "Plugins API" page, and all of the plugin docs are > moved > >> > into > >> > > the respective repos within a doc/index.md file. > >> > > > >> > > Some of doc/index.md files are fairly large, and to help with that > I > >> > > attempted to remove some of the repetition that I found: Quick > >> Examples > >> > vs. > >> > > Full Examples, Overviews vs Descriptions (in cases where they were > >> saying > >> > > the same thing). > >> > > > >> > > Also - for the file API, I just wrote to refer to the FileSystem > spec > >> for > >> > > the API and copied over only the Cordova platform quirks. This will > >> be a > >> > > bad offline experience, so I'm not 100% convinced that was the right > >> > thing > >> > > to do, but wow is that file big if you were to copy over all of the > >> > > documentation! > >> > > > >> > > https://github.com/apache/cordova-plugin-file/blob/dev/doc/index.md > >> > > > >> > > >> > > >> > > >> > -- > >> > Carlos Santana > >> > > >> > > >> > > > > > > > > -- > > Carlos Santana > > > > > > > > -- > Carlos Santana > > --089e013c5af0ffc0cb04edfc1bdb--