open writing ! -collaborative authoring on apache’s first open-source cloud computing project
DESCRIPTION
TRANSCRIPT
![Page 1: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/1.jpg)
Radhika PC 12/1/12
Open Writing For Apache CloudStack
![Page 2: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/2.jpg)
Credits
• Apache CloudStack Contributors
• Jessica Tomechak
• Ram Chinta
• Archana Maheshwari
• Deepti Dohare
![Page 3: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/3.jpg)
Agenda
•What is Apache CloudStack?
•The Apache Way™
•Apache CloudStack TechPubs
![Page 4: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/4.jpg)
•What is Apache CloudStack?
•The Apache Way™
•Apache CloudStack TechPubs
![Page 5: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/5.jpg)
CloudStack: Key Highlights
A proven Infrastructure As a Service (IAAS) Cloud Platform
Hypervisor Agnostic Scalable Architecture
![Page 6: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/6.jpg)
Apache CloudStack: Architecture
Any Servers Any Storage Any Networking
Open Source Xen Hypervisor
Amazon Proprietary Orchestration Software
AWS API (EC2, S3, …)
Amazon eCommerce Platform
vSphere XenServer KVM
Apache CloudStack
Portal and End User Experience
Cloud API
![Page 7: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/7.jpg)
CloudStack: Trodden Path
• Developed since 2008 by Cloud.com
• Citrix acquired Cloud.com in 2011
• Donated to the Apache Software Foundation (ASF) in April 2012, where it is now an Incubator project
• First ASFCS 4.0.0-Incubator released in November 2012
• Powering some of the world’s largest clouds today
![Page 8: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/8.jpg)
•What is Apache CloudStack?
•The Apache Way™
•Apache CloudStack Techubs
![Page 9: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/9.jpg)
![Page 10: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/10.jpg)
Apache Contributor to Committer
![Page 11: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/11.jpg)
Process to
Become an
Incubation
Project
![Page 12: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/12.jpg)
Process to
Become a Top-
Level Apache
Project
![Page 13: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/13.jpg)
The Apache Way
• Pure meritocracy
• Earn the merit
• Peer to peer
• Open communication
• Decision is made by voting
• Low barrier to contribution
![Page 14: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/14.jpg)
•What is Apache CloudStack?
•The Apache Way
•Apache CloudStack TechPubs
![Page 15: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/15.jpg)
At work..
A Citrix CloudPlatform Writer
If not at work..
An Apache CloudStack Contributor
![Page 16: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/16.jpg)
Traditional Writing Open-Source Writing
Authoring Authoring Contributor Features
Peer Reviews Peer Reviews + Contributor Doc Reviews in Open
Status/Process Updates Non-Voice IRC Chat + Wikis
Meetings Meetings + Meetups+ Mailing List
Learning Learning—Wider Boundary
Defect Fixing Fixing Defects on Contributor Features
Hack Weeks
Fun Time with Social Media
Wearing Two Hats
![Page 17: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/17.jpg)
Two Sides of the Same Coin..
What drives you..
..Passion is the word
…Visibility
….Opportunities
What deters you..
.. if you are not doing what you really love to do
…if you are thin-skinned
….if you are insecure
….if you are not open
![Page 18: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/18.jpg)
Proprietary to Open: Where We Were
• Two Resources and three months !
• Three Proprietary releases and one Open-Source release!
• ~ 500 pages of documentation in Microsoft Word !
![Page 19: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/19.jpg)
Unstructured to Modular Source: Non-
Automation
Modular source
Converted to DocBook XML—manually ! Updated old sections
Copy edited
Improved doc design and modularity
![Page 20: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/20.jpg)
Publishing with Publican
• Easy to set up
• Applies brands to “skin" content
• Uses conditional tags
• Generates a variety of output formats
• Generates .po files for translators
![Page 21: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/21.jpg)
Publican: Example Configuration File
xml_lang: en-US
type: Book
docname: Installation_Guide
brand: cloudstack
chunk_first: 1
chunk_section_depth: 1
condition: install
Output type
Publican looks for an XML file with this name
and uses that as the main book file
The product logo, CSS styles, copyright text,
navigation button images etc. are set in the
brand
Chunk settings control when Publican starts a
new HTML output file
Conditional text marked with any other label
will be excluded from the output
![Page 22: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/22.jpg)
Mechanics
![Page 23: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/23.jpg)
The Apache Documentation Process
• Functional Spec discussions on [email protected]
• Sign up for a feature
• Documentation Reviews through Apache Review Board—https://reviews.apache.org/
• Defects are filed at https://issues.apache.org/jira/browse/CLOUDSTACK
![Page 24: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/24.jpg)
Apache Review Board
24
Submit a Patch
Review
Comments?
Ship it!
No
Yes
![Page 25: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/25.jpg)
Documentation Reviews
![Page 26: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/26.jpg)
Demo
![Page 27: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/27.jpg)
Join the Community….
• Check us out @ ᵒ cwiki.apache.org/confluence/display/CLOUDSTACK/Index ᵒ http://cloudstack.org
• IRC: #cloudstack on irc.freenode.net
• Forums: http://cloudstack.org/forum/
• Subscribe to Mailing Lists @ [email protected] [email protected]
• Join Apache CloudStack Bangalore Meetup Group http://www.meetup.com/CloudStack-Bangalore-Group/
• Join Apache CloudStack Facebook Group @https://www.facebook.com/groups/cloudstack/
![Page 28: Open Writing ! -Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project](https://reader034.vdocuments.mx/reader034/viewer/2022051513/546ca95db4af9f7a2c8b5141/html5/thumbnails/28.jpg)
Q & A