SlideShare a Scribd company logo
Open Writing
For Apache CloudStack

                        Radhika PC
                        12/1/12
Credits
   • Apache CloudStack Contributors
   • Jessica Tomechak
   • Ram Chinta
   • Archana Maheshwari
   • Deepti Dohare
Agenda
•What is Apache CloudStack?
•The Apache Way™
•Apache CloudStack TechPubs
•What is Apache CloudStack?
•The Apache Way™
•Apache CloudStack TechPubs
CloudStack: Key Highlights


A proven Infrastructure
 As a Service (IAAS) Cloud
 Platform
Hypervisor Agnostic
Scalable Architecture
Apache CloudStack: Architecture

            Portal and End User Experience
             Amazon eCommerce Platform

                 AWS API (EC2, S3, …)
                     Cloud API

     Amazon Proprietary CloudStack Software
               Apache Orchestration


             vSphere XenServer KVM
             Open Source Xen Hypervisor

     Any Networking   Any Servers       Any Storage
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
•What is Apache CloudStack?
•The Apache Way™
•Apache CloudStack Techubs
Open Writing ! -	Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project
Apache Contributor to Committer
Process to
Become an
Incubation
  Project
Process to
Become a Top-
Level Apache
   Project
The Apache Way

     •   Pure meritocracy
     •   Earn the merit
     •   Peer to peer
     •   Open communication
     •   Decision is made by voting
     •   Low barrier to contribution
•What is Apache CloudStack?
•The Apache Way
•Apache CloudStack TechPubs
At work..
       A Citrix CloudPlatform Writer




If not at work..
     An Apache CloudStack Contributor
Wearing Two Hats
        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
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
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 !
Unstructured to Modular Source: Non-
Automation
   Modular source
   Converted to DocBook XML—manually !
      Updated old sections
      Copy edited
      Improved doc design and modularity
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
Publican: Example Configuration File

                              Output type


xml_lang: en-US               Publican looks for an XML file with this name
type: Book                    and uses that as the main book file
docname: Installation_Guide
brand: cloudstack             The product logo, CSS styles, copyright text,
chunk_first: 1                navigation button images etc. are set in the
chunk_section_depth: 1        brand
condition: install
                              Chunk settings control when Publican starts a
                              new HTML output file

                              Conditional text marked with any other label
                              will be excluded from the output
Mechanics
The Apache Documentation Process

• Functional Spec discussions on cloudstack-
  dev@incubator.apache.org
• 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
Apache Review Board

                     Submit a Patch




                        Review


                                      Yes


                      Comments?


                              No



                         Ship it!




24
Documentation Reviews
Demo
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 @
    cloudstack-dev@incubator.apache.org
    cloudstack-users@incubator.apache.org
•   Join Apache CloudStack Bangalore Meetup Group
    http://www.meetup.com/CloudStack-Bangalore-Group/
•   Join Apache CloudStack Facebook Group
    @https://www.facebook.com/groups/cloudstack/
Q&A

More Related Content

PDF
2.28.17 Introducing DSpace 7 Webinar Slides
PPT
Introducing the New DSpace User Interface
PPTX
3.15.17 DSpace: How to Contribute Webinar Slides
PDF
Intro to SharePoint 2010 development for .NET developers
PPTX
Design for scale
PPT
Jive, dropbox and other integrations
PPTX
DevOps Columbus Meetup Kickoff - Infrastructure as Code
KEY
WordPress APIs
2.28.17 Introducing DSpace 7 Webinar Slides
Introducing the New DSpace User Interface
3.15.17 DSpace: How to Contribute Webinar Slides
Intro to SharePoint 2010 development for .NET developers
Design for scale
Jive, dropbox and other integrations
DevOps Columbus Meetup Kickoff - Infrastructure as Code
WordPress APIs

What's hot (20)

PDF
Building Enterprise Grade Front-End Applications with JavaScript Frameworks
PDF
eMusic: WordPress in the Enterprise
PPTX
14 Habits of Great SQL Developers
PDF
Modern websites in 2020 and Joomla
PDF
DownTheRabbitHole.js – How to Stay Sane in an Insane Ecosystem
PPTX
2014 SpiceWorld London Breakout
PPTX
OpenSocial gadgets at Eclipse
PDF
A Day of REST
PDF
JavaScript debugging diagnostic web tools and firefox
PPTX
Best Practices in SharePoint Development - Just Freakin Work! Overcoming Hurd...
PPTX
Devops kc meetup_5_20_2013
PPTX
14 Habits of Great SQL Developers
PDF
Apereo OAE - Bootcamp
PDF
Docker and serverless Randstad Jan 2019: OpenFaaS Serverless: when functions ...
PDF
WordPress: Getting Under the Hood
PDF
2-5-14 “DSpace User Interface Innovation” Presentation Slides
PPTX
SofiaDev L9 Source Control Management
PDF
Big Data! Great! Now What? #SymfonyCon 2014
KEY
State-of-the-Art Drupal Search with Apache Solr
PPT
Domino testing presentation
Building Enterprise Grade Front-End Applications with JavaScript Frameworks
eMusic: WordPress in the Enterprise
14 Habits of Great SQL Developers
Modern websites in 2020 and Joomla
DownTheRabbitHole.js – How to Stay Sane in an Insane Ecosystem
2014 SpiceWorld London Breakout
OpenSocial gadgets at Eclipse
A Day of REST
JavaScript debugging diagnostic web tools and firefox
Best Practices in SharePoint Development - Just Freakin Work! Overcoming Hurd...
Devops kc meetup_5_20_2013
14 Habits of Great SQL Developers
Apereo OAE - Bootcamp
Docker and serverless Randstad Jan 2019: OpenFaaS Serverless: when functions ...
WordPress: Getting Under the Hood
2-5-14 “DSpace User Interface Innovation” Presentation Slides
SofiaDev L9 Source Control Management
Big Data! Great! Now What? #SymfonyCon 2014
State-of-the-Art Drupal Search with Apache Solr
Domino testing presentation
Ad

Similar to Open Writing ! - Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project (20)

PDF
7 Apache Process Cloudstack Developer Day
PPTX
OpenStack Introduction
PDF
"Open Source and the Choice to Cooperate" by Brian Behlendorf @ eLiberatica 2007
PPTX
Introduction to Open Source, Apache and Apache Way
PDF
Cloud stack design camp on jun 15
ODP
The lessons of Open Source for the Open Cloud
PPTX
OpenStack Documentation in the Open
PPTX
Opensource development and apache software foundation
PPSX
Open writing-cloud-collab
PPTX
Open Writing! Collaborative Authoring for CloudStack Documentation by Jessica...
PPTX
Social web for Tech Comm, STC March 2013
PDF
Contributing to Open Source
PDF
Linux Foundation Collaboration Summit: Hitchhiker's Guide to the Cloud
PDF
Stangel open stack community activity board and metrics 041513
PDF
Who Built Grizzly
PDF
01.19.2011 AIIT InfoTalk on OpenStack
PPTX
OpenStack Documentation Projects and Processes
PDF
LinuxFest NW 2013: Hitchhiker's Guide to Open Source Cloud Computing
PDF
Tales From The Ship: Navigating the OpenStack Community Seas
ODP
Open sourcery
7 Apache Process Cloudstack Developer Day
OpenStack Introduction
"Open Source and the Choice to Cooperate" by Brian Behlendorf @ eLiberatica 2007
Introduction to Open Source, Apache and Apache Way
Cloud stack design camp on jun 15
The lessons of Open Source for the Open Cloud
OpenStack Documentation in the Open
Opensource development and apache software foundation
Open writing-cloud-collab
Open Writing! Collaborative Authoring for CloudStack Documentation by Jessica...
Social web for Tech Comm, STC March 2013
Contributing to Open Source
Linux Foundation Collaboration Summit: Hitchhiker's Guide to the Cloud
Stangel open stack community activity board and metrics 041513
Who Built Grizzly
01.19.2011 AIIT InfoTalk on OpenStack
OpenStack Documentation Projects and Processes
LinuxFest NW 2013: Hitchhiker's Guide to Open Source Cloud Computing
Tales From The Ship: Navigating the OpenStack Community Seas
Open sourcery
Ad

More from Radhika Puthiyetath (12)

PDF
The Apache Way (And How Not to Break Builds!)
PDF
IISc Project Presentation
PDF
Corporate Websites Improvement Areas
PDF
Technical Publication Process
PDF
Clarity in Documentation
PDF
Doc publishing -LeanSixSigma Project
PDF
On CloudStack, Docker, Kubernetes, and Big Data…Oh my ! By Sebastien Goasguen...
PPTX
Automation Using Marvin Framework by Sowmya Krishnan
PDF
Troubleshooting Apache Cloudstack
PDF
Nexenta Powered by Apache CloudStack from Iliyas Shirol
PDF
Cloud stack for_beginners
PDF
Automating Content Translation Workflow with Transifex
The Apache Way (And How Not to Break Builds!)
IISc Project Presentation
Corporate Websites Improvement Areas
Technical Publication Process
Clarity in Documentation
Doc publishing -LeanSixSigma Project
On CloudStack, Docker, Kubernetes, and Big Data…Oh my ! By Sebastien Goasguen...
Automation Using Marvin Framework by Sowmya Krishnan
Troubleshooting Apache Cloudstack
Nexenta Powered by Apache CloudStack from Iliyas Shirol
Cloud stack for_beginners
Automating Content Translation Workflow with Transifex

Recently uploaded (20)

PDF
Unlocking AI with Model Context Protocol (MCP)
PDF
[발표본] 너의 과제는 클라우드에 있어_KTDS_김동현_20250524.pdf
PDF
Chapter 3 Spatial Domain Image Processing.pdf
PDF
Blue Purple Modern Animated Computer Science Presentation.pdf.pdf
PDF
How UI/UX Design Impacts User Retention in Mobile Apps.pdf
PPTX
Cloud computing and distributed systems.
PPTX
Detection-First SIEM: Rule Types, Dashboards, and Threat-Informed Strategy
PDF
CIFDAQ's Market Insight: SEC Turns Pro Crypto
PPTX
Effective Security Operations Center (SOC) A Modern, Strategic, and Threat-In...
PDF
Machine learning based COVID-19 study performance prediction
PDF
Bridging biosciences and deep learning for revolutionary discoveries: a compr...
PDF
KodekX | Application Modernization Development
PPTX
PA Analog/Digital System: The Backbone of Modern Surveillance and Communication
PDF
Diabetes mellitus diagnosis method based random forest with bat algorithm
PPTX
MYSQL Presentation for SQL database connectivity
PPTX
VMware vSphere Foundation How to Sell Presentation-Ver1.4-2-14-2024.pptx
PDF
Dropbox Q2 2025 Financial Results & Investor Presentation
PDF
Electronic commerce courselecture one. Pdf
PDF
Review of recent advances in non-invasive hemoglobin estimation
PDF
GDG Cloud Iasi [PUBLIC] Florian Blaga - Unveiling the Evolution of Cybersecur...
Unlocking AI with Model Context Protocol (MCP)
[발표본] 너의 과제는 클라우드에 있어_KTDS_김동현_20250524.pdf
Chapter 3 Spatial Domain Image Processing.pdf
Blue Purple Modern Animated Computer Science Presentation.pdf.pdf
How UI/UX Design Impacts User Retention in Mobile Apps.pdf
Cloud computing and distributed systems.
Detection-First SIEM: Rule Types, Dashboards, and Threat-Informed Strategy
CIFDAQ's Market Insight: SEC Turns Pro Crypto
Effective Security Operations Center (SOC) A Modern, Strategic, and Threat-In...
Machine learning based COVID-19 study performance prediction
Bridging biosciences and deep learning for revolutionary discoveries: a compr...
KodekX | Application Modernization Development
PA Analog/Digital System: The Backbone of Modern Surveillance and Communication
Diabetes mellitus diagnosis method based random forest with bat algorithm
MYSQL Presentation for SQL database connectivity
VMware vSphere Foundation How to Sell Presentation-Ver1.4-2-14-2024.pptx
Dropbox Q2 2025 Financial Results & Investor Presentation
Electronic commerce courselecture one. Pdf
Review of recent advances in non-invasive hemoglobin estimation
GDG Cloud Iasi [PUBLIC] Florian Blaga - Unveiling the Evolution of Cybersecur...

Open Writing ! - Collaborative Authoring on Apache’s First Open-Source Cloud Computing Project

  • 1. Open Writing For Apache CloudStack Radhika PC 12/1/12
  • 2. Credits • Apache CloudStack Contributors • Jessica Tomechak • Ram Chinta • Archana Maheshwari • Deepti Dohare
  • 3. Agenda •What is Apache CloudStack? •The Apache Way™ •Apache CloudStack TechPubs
  • 4. •What is Apache CloudStack? •The Apache Way™ •Apache CloudStack TechPubs
  • 5. CloudStack: Key Highlights A proven Infrastructure As a Service (IAAS) Cloud Platform Hypervisor Agnostic Scalable Architecture
  • 6. Apache CloudStack: Architecture Portal and End User Experience Amazon eCommerce Platform AWS API (EC2, S3, …) Cloud API Amazon Proprietary CloudStack Software Apache Orchestration vSphere XenServer KVM Open Source Xen Hypervisor Any Networking Any Servers Any Storage
  • 7. 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
  • 8. •What is Apache CloudStack? •The Apache Way™ •Apache CloudStack Techubs
  • 12. Process to Become a Top- Level Apache Project
  • 13. The Apache Way • Pure meritocracy • Earn the merit • Peer to peer • Open communication • Decision is made by voting • Low barrier to contribution
  • 14. •What is Apache CloudStack? •The Apache Way •Apache CloudStack TechPubs
  • 15. At work.. A Citrix CloudPlatform Writer If not at work.. An Apache CloudStack Contributor
  • 16. Wearing Two Hats 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
  • 17. 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
  • 18. 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 !
  • 19. Unstructured to Modular Source: Non- Automation  Modular source  Converted to DocBook XML—manually !  Updated old sections  Copy edited  Improved doc design and modularity
  • 20. 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
  • 21. Publican: Example Configuration File Output type xml_lang: en-US Publican looks for an XML file with this name type: Book and uses that as the main book file docname: Installation_Guide brand: cloudstack The product logo, CSS styles, copyright text, chunk_first: 1 navigation button images etc. are set in the chunk_section_depth: 1 brand condition: install Chunk settings control when Publican starts a new HTML output file Conditional text marked with any other label will be excluded from the output
  • 23. The Apache Documentation Process • Functional Spec discussions on cloudstack- dev@incubator.apache.org • 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
  • 24. Apache Review Board Submit a Patch Review Yes Comments? No Ship it! 24
  • 26. Demo
  • 27. 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 @ cloudstack-dev@incubator.apache.org cloudstack-users@incubator.apache.org • Join Apache CloudStack Bangalore Meetup Group http://www.meetup.com/CloudStack-Bangalore-Group/ • Join Apache CloudStack Facebook Group @https://www.facebook.com/groups/cloudstack/
  • 28. Q&A