lfrancke commented on a change in pull request #11: Release navigating incubator
URL: https://github.com/apache/incubator-training/pull/11#discussion_r284851312
 
 

 ##########
 File path: content/ApacheWay/NavigatingASFIncubation/README.md
 ##########
 @@ -0,0 +1,76 @@
+
+# Navigating the ASF Incubation Process
+
+An overview of how to navigate the ASF incubating process from start to finish.
+
+It can seem like a daunting task to bring a new open source project into the 
world. The Apache Software Foundation incubator can help you! Getting into the 
incubator and surviving incubation is straight forward when you know what to do 
and how to do it. This talk gives an overview of the ASF incubation process, 
the pitfalls to watch out for, and how projects become successful. It also 
gives an overview of the incubator PMC, how to interact with other podlings and 
make your mark on the ecosystem and finally how to make it as a top-level 
project at the Apache Software Foundation. It also goes over some the 
challenges that your project may face along the path to graduation.
+
+## About the Apache Training (Incubating) Project
+
+The purpose of the Training project is to create high-quality training 
material for various projects in an open source form. Up until now everyone who 
wants to offer a Training course for one of the Apache projects needs to create 
her or his own slides/labs and keep them up-to-date. This is a significant 
investment of time and money. This project aims to spread that burden and help 
all Apache projects as we can create shared resources and we can also create 
cross-project training resources.
+
+## How to Get Involved
+
+Vist [Apache Training (incubating)](https://training.apache.org) for more 
information on the project.
+These slides can be found in 
[github](https://github.com/apache/incubator-training/tree/master/content/ApacheWay/NavigatingASFIncubation.).
 Pull requests welcome.
+
+[I'm an inline-style link](https://www.google.com)
+
+## Technology Used
+
+The slides are generated from [asciidoctor](https://asciidoctor.org) markup 
and displayed with 
[reveal.js](https://asciidoctor.org/docs/asciidoctor-revealjs/). This means the 
content can be kept under version control and exported to a number of formats 
other than HTML.
+
+## How to Use the Slides
+
+First edit the author, email and position information found in the title slide 
ot the top of slide content file here:
+
+`./src/main/asciidoc/index.adoc`
+
+Editing any of the content there will change content on the slides.
+
+Then edit the information that will appear in the about me slide found here:
+
+`./src/main/asciidoc/aboutme.adoc`
+
+Then build the slides to generate the HTML.
+
+## How to Build
+
+To installed the needed dependencies run:
+
+`install-deps.sh`
+
+Then run:
+
+`mvn clean compile`
+
+## How to Update the ASF Statistics
+
+To update the ASF statistics (no of podlings, no of committers etc. etc.) run:
+
+`python3 stats.py > asciidoc/projectstats.adoc`
+
+## How to View the Slides
+
+Once built, the generated slides can be found at:
 
 Review comment:
   Should probably include Chris' recommended way of looking at the slides 
using Jetty

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


With regards,
Apache Git Services

Reply via email to