From dev-return-50591-apmail-cloudstack-dev-archive=cloudstack.apache.org@cloudstack.apache.org Wed Jan 22 17:27:56 2014 Return-Path: X-Original-To: apmail-cloudstack-dev-archive@www.apache.org Delivered-To: apmail-cloudstack-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 0E5611040A for ; Wed, 22 Jan 2014 17:27:56 +0000 (UTC) Received: (qmail 51392 invoked by uid 500); 22 Jan 2014 17:27:53 -0000 Delivered-To: apmail-cloudstack-dev-archive@cloudstack.apache.org Received: (qmail 51346 invoked by uid 500); 22 Jan 2014 17:27:53 -0000 Mailing-List: contact dev-help@cloudstack.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cloudstack.apache.org Delivered-To: mailing list dev@cloudstack.apache.org Received: (qmail 51338 invoked by uid 99); 22 Jan 2014 17:27:53 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 22 Jan 2014 17:27:53 +0000 X-ASF-Spam-Status: No, hits=-0.0 required=5.0 tests=RCVD_IN_DNSWL_NONE,SPF_HELO_PASS,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of alex.hitchins@shapeblue.com designates 213.199.154.10 as permitted sender) Received: from [213.199.154.10] (HELO emea01-am1-obe.outbound.protection.outlook.com) (213.199.154.10) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 22 Jan 2014 17:27:46 +0000 Received: from DB3PR07MB028.eurprd07.prod.outlook.com (10.242.137.156) by DB3PR07MB027.eurprd07.prod.outlook.com (10.242.137.147) with Microsoft SMTP Server (TLS) id 15.0.851.15; Wed, 22 Jan 2014 17:27:24 +0000 Received: from DB3PR07MB028.eurprd07.prod.outlook.com ([169.254.1.119]) by DB3PR07MB028.eurprd07.prod.outlook.com ([169.254.1.119]) with mapi id 15.00.0851.011; Wed, 22 Jan 2014 17:27:24 +0000 From: Alex Hitchins To: "dev@cloudstack.apache.org" Subject: RE: [DOCS][PROPOSAL] Move to .rst and new repos Thread-Topic: [DOCS][PROPOSAL] Move to .rst and new repos Thread-Index: AQHPF5XuHIHczUnAnUy21tpRGSu+z5qQ/mSg Date: Wed, 22 Jan 2014 17:27:23 +0000 Message-ID: References: <3D18A0DF-5BF3-413E-98C0-5E5F50765C13@gmail.com> In-Reply-To: <3D18A0DF-5BF3-413E-98C0-5E5F50765C13@gmail.com> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [86.174.251.207] x-forefront-prvs: 00997889E7 x-forefront-antispam-report: SFV:NSPM;SFS:(10009001)(6009001)(13464003)(189002)(199002)(13734003)(54094003)(90146001)(31966008)(15395725003)(74502001)(47446002)(81342001)(85806002)(93516002)(83072002)(74662001)(15202345003)(56816005)(74706001)(87266001)(69226001)(561944002)(74366001)(74876001)(77982001)(85306002)(2656002)(74316001)(85852003)(65816001)(47976001)(81542001)(46102001)(87936001)(50986001)(80976001)(16601075003)(54356001)(76482001)(54316002)(83322001)(4396001)(47736001)(49866001)(63696002)(66066001)(59766001)(81686001)(33646001)(15975445006)(56776001)(79102001)(81816001)(19580405001)(92566001)(80022001)(93136001)(53806001)(51856001)(76576001)(19580395003)(76786001)(86362001)(76796001)(77096001)(200143001)(142923001)(24736002);DIR:OUT;SFP:1101;SCL:1;SRVR:DB3PR07MB027;H:DB3PR07MB028.eurprd07.prod.outlook.com;CLIP:86.174.251.207;FPR:;RD:InfoNoRecords;MX:1;A:1;LANG:en; Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: shapeblue.com X-Virus-Checked: Checked by ClamAV on apache.org Personally, I think if possible; http://docs.cloudstack.apache.org could go to a page with both sets availab= le, linking to http://admin.docs.cloudstack.apache.org http://install.docs.cloudstack.apache.org My thinking is docs.cloudstack.apache.org is easier to remember. I wonder if there is a SEO benefit to either option. Be good it the install= and admin guides we well crawled. Alex Hitchins +44 7788 423 969 -----Original Message----- From: sebgoa [mailto:runseb@gmail.com] Sent: 22 January 2014 17:18 To: dev@cloudstack.apache.org Subject: [DOCS][PROPOSAL] Move to .rst and new repos Hi, Prior to the break we had a discussion to move to a new doc format RST. In investigating the process and the infra needed for this, David and I tho= ught that having a repo for each guide/book would be good. Otherwise the readthedocs build infra will create one massive pdf/epub, thi= nk ~400 pages. So David created couple repos: cloudstack-docs-admin.git cloudstack-docs-install.git Now we need to decide on CNAMEs for each guide, meaning that to get to the = admin guide (for instance) you will hit http://admin.foo ... We propose to use: http://docs-admin.cloudstack.apache.org http://docs-install.cloudstack.apache.org thoughts ? better ideas ? -Sebastien Need Enterprise Grade Support for Apache CloudStack? Our CloudStack Infrastructure Support offers the best 24/7 SLA for CloudStack Environments. Apache CloudStack Bootcamp training courses **NEW!** CloudStack 4.2.1 training 18th-19th February 2014, Brazil. Classroom 17th-23rd March 2014, Region A. Instructor led, On-line 24th-28th March 2014, Region B. Instructor led, On-line 16th-20th June 2014, Region A. Instructor led, On-line 23rd-27th June 2014, Region B. Instructor led, On-line This email and any attachments to it may be confidential and are intended s= olely for the use of the individual to whom it is addressed. Any views or o= pinions expressed are solely those of the author and do not necessarily rep= resent those of Shape Blue Ltd or related companies. If you are not the int= ended recipient of this email, you must neither take any action based upon = its contents, nor copy or show it to anyone. Please contact the sender if y= ou believe you have received this email in error. Shape Blue Ltd is a compa= ny incorporated in England & Wales. ShapeBlue Services India LLP is a compa= ny incorporated in India and is operated under license from Shape Blue Ltd.= Shape Blue Brasil Consultoria Ltda is a company incorporated in Brasil and= is operated under license from Shape Blue Ltd. ShapeBlue is a registered t= rademark.