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 8284BEDF5 for ; Mon, 14 Jan 2013 17:22:51 +0000 (UTC) Received: (qmail 93324 invoked by uid 500); 14 Jan 2013 17:22:51 -0000 Delivered-To: apmail-cordova-dev-archive@cordova.apache.org Received: (qmail 93293 invoked by uid 500); 14 Jan 2013 17:22:51 -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 93284 invoked by uid 99); 14 Jan 2013 17:22:51 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 14 Jan 2013 17:22:51 +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 (athena.apache.org: domain of mikeywbrooks@gmail.com designates 209.85.219.52 as permitted sender) Received: from [209.85.219.52] (HELO mail-oa0-f52.google.com) (209.85.219.52) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 14 Jan 2013 17:22:47 +0000 Received: by mail-oa0-f52.google.com with SMTP id o6so4290380oag.11 for ; Mon, 14 Jan 2013 09:22:26 -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 :x-google-sender-auth:message-id:subject:from:to:content-type; bh=HKGS919COvCwAhAbk5FcWhwMuBG6E+kUg4BLjuAfddI=; b=kLFuTS18YX+nkYOrruuhZVE/A2ez3vy/0kaPnn8kbe0DsdS1+vQM85Qz86C/NNar3B jIA0DxLN8eZPTyjwpvlsrv7DbnL/MIWwWpb73glu0B46wdC+Y/ot6Wrc17eeH0VriMzK AFttzOo/BDnl+DXltl74JHhPU2g1UPCXWRFCZFU2AOoPWPyX2Bl8kfyFcu/B9BZYPe7/ gBN07p/mDOP3gZk/vBgmpwF/pIBDw0EdntVs3SgoAOtgrl7U6SPoPgjttnhyvSIzRmSQ Nh4rEM8iNDHKBI/cu5LM6/6hoclPn6y9WhIIVFqiYsLGC2VTMeh4I6a++46Z6BqvXGkR xHoA== MIME-Version: 1.0 Received: by 10.60.32.39 with SMTP id f7mr51553547oei.86.1358184146561; Mon, 14 Jan 2013 09:22:26 -0800 (PST) Sender: mikeywbrooks@gmail.com Received: by 10.182.26.10 with HTTP; Mon, 14 Jan 2013 09:22:26 -0800 (PST) In-Reply-To: References: <50F435B2.6010701@gmail.com> Date: Mon, 14 Jan 2013 09:22:26 -0800 X-Google-Sender-Auth: v39KDgKu6N8eRRoKbIy4fB0WEl8 Message-ID: Subject: Re: docs on cordova.apache.org From: Michael Brooks To: dev@cordova.apache.org Content-Type: multipart/alternative; boundary=e89a8fb1eb8a986a4804d342e330 X-Virus-Checked: Checked by ClamAV on apache.org --e89a8fb1eb8a986a4804d342e330 Content-Type: text/plain; charset=ISO-8859-1 @Andrew I was thinking S3 so that a service can auto-update on each commit. >From Yohei's experience with the cordova.apache.org SVN setup, it looks like automating that is a headache. Michael On Mon, Jan 14, 2013 at 9:16 AM, Andrew Grieve wrote: > cordova.io is a bunch of redirects. Do you mean to have > docs.cordova.ioredirect to > cordova.apache.org/docs (or something similar) > > > On Mon, Jan 14, 2013 at 12:13 PM, Michael Brooks > wrote: > > > Hi Marcel, > > > > I've got this one my roadmap of tasks. > > > > The short-term goal is to have http://docs.cordova.io host our > > documentation and we'll link to it off http://cordova.io. > > > > The longer-term goal is to have the generator and possibly templates > > decoupled from the documentation. At that time, we'll redesign the > > http://docs.cordova.io to use the http://cordova.io site design. > > > > My plan is to start this work on February 1st and have it completed for > the > > next board report. > > > > Michael > > > > On Mon, Jan 14, 2013 at 8:52 AM, Ross Gardler < > rgardler@opendirective.com > > >wrote: > > > > > It not only makes sense I would consider it a priority. Having the only > > > source of docs on a third party website is a no-go as far as I'm > > concerned. > > > I raised this issue during incubation and was assured it was a > > transitional > > > thing. > > > > > > Ross > > > > > > Sent from a mobile device, please excuse mistakes and brevity > > > On 14 Jan 2013 08:44, "Marcel Kinard" wrote: > > > > > > > Would it make sense to host a copy of the docs on cordova.apache.org > ? > > > > Other Apache projects have their docs online at their apache.orgsite. > > > > > > > > A couple possibilities: > > > > 1) build the html files and zip them up, so a consumer needs to only > > > > download and unzip and point their browser at their local offline > copy. > > > > 2) build the html files and post them unpacked to > cordova.apache.orgso > > > > they can be browsed directly without a zip or src download. > > > > > > > > My initial suggestion is to do both: something like /docs/download to > > > hold > > > > the zip files and /docs/browse to have the tree starting with > > index.html. > > > > > > > > Or would it be better to host it in www.apache.org/dist/cordova? > > > > > > > > I am willing to do the initial setup and load. > > > > > > > > Comments? > > > > > > > > -- Marcel Kinard > > > > > > > > > > --e89a8fb1eb8a986a4804d342e330--