This is an automated email from the ASF dual-hosted git repository.
soenkeliebau pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-training.git
The following commit(s) were added to refs/heads/master by this push:
new 35a7f0b Added presentation "How To Slide Your Release Past The
Incubator" (#28)
35a7f0b is described below
commit 35a7f0b4149296f3379be5eb6068f544739a088e
Author: Justin Mclean <[email protected]>
AuthorDate: Mon Jun 17 18:02:55 2019 +1000
Added presentation "How To Slide Your Release Past The Incubator" (#28)
---
.gitignore | 3 +
content/ApacheWay/IncubatorReleases/DISCLAIMER | 8 +
content/ApacheWay/IncubatorReleases/LICENSE | 232 ++++++++++++
content/ApacheWay/IncubatorReleases/NOTICE | 8 +
content/ApacheWay/IncubatorReleases/README.md | 82 +++++
content/ApacheWay/IncubatorReleases/clean-deps.sh | 22 ++
.../ApacheWay/IncubatorReleases/install-deps.sh | 51 +++
content/ApacheWay/IncubatorReleases/pom.xml | 324 ++++++++++++++++
content/ApacheWay/IncubatorReleases/release.sh | 34 ++
.../src/main/asciidoc/aboutme.adoc | 20 +
.../IncubatorReleases/src/main/asciidoc/index.adoc | 409 +++++++++++++++++++++
.../src/main/asciidoc/projectstats.adoc | 26 ++
.../src/main/resources/images/33BSD.mp4 | Bin 0 -> 1568618 bytes
.../src/main/resources/images/ApacheLogo.png | Bin 0 -> 82055 bytes
.../main/resources/images/IncubatingProjects.png | Bin 0 -> 1438706 bytes
.../src/main/resources/images/LICENSE.png | Bin 0 -> 173968 bytes
.../src/main/resources/images/NOTICE.png | Bin 0 -> 47654 bytes
.../src/main/resources/images/VoteData.png | Bin 0 -> 29953 bytes
.../src/main/resources/images/both.mp4 | Bin 0 -> 741137 bytes
.../src/main/resources/images/deadpeople.mp4 | Bin 0 -> 1316741 bytes
.../src/main/resources/images/rat.png | Bin 0 -> 106708 bytes
.../src/main/resources/images/small-feather.png | Bin 0 -> 11470 bytes
.../src/main/resources/images/wtf.mp4 | Bin 0 -> 1367496 bytes
.../ApacheWay/IncubatorReleases/src/main/stats.py | 75 ++++
.../IncubatorReleases/src/main/theme/apache.css | 397 ++++++++++++++++++++
.../src/main/asciidoc/index.adoc | 2 +-
26 files changed, 1692 insertions(+), 1 deletion(-)
diff --git a/.gitignore b/.gitignore
index 17a5068..a0d761f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -132,3 +132,6 @@ fabric.properties
# Editor-based Rest Client
.idea/httpRequests
+.history
+.vscode
+.classpath
diff --git a/content/ApacheWay/IncubatorReleases/DISCLAIMER
b/content/ApacheWay/IncubatorReleases/DISCLAIMER
new file mode 100644
index 0000000..d9fc464
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/DISCLAIMER
@@ -0,0 +1,8 @@
+Apache Training is an effort undergoing incubation at The Apache Software
+Foundation (ASF), sponsored by the Apache Incubator. Incubation is required
+of all newly accepted projects until a further review indicates that the
+infrastructure, communications, and decision making process have stabilized
+in a manner consistent with other successful ASF projects. While incubation
+status is not necessarily a reflection of the completeness or stability of
+the code, it does indicate that the project has yet to be fully endorsed by
+the ASF.
diff --git a/content/ApacheWay/IncubatorReleases/LICENSE
b/content/ApacheWay/IncubatorReleases/LICENSE
new file mode 100644
index 0000000..a9ad328
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/LICENSE
@@ -0,0 +1,232 @@
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+
+----------------------------------------------
+
+This product includes a modified version of this file:
+./libs/docinfo-hack/document.html.slim
+developed at https://github.com/asciidoctor/asciidoctor-reveal.js
+
+Available under an MIT license:
+
+The MIT License
+Copyright (C) 2012-2019 Olivier Bilodeau, Charles Moulliard, Dan Allen and the
Asciidoctor Project
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file
diff --git a/content/ApacheWay/IncubatorReleases/NOTICE
b/content/ApacheWay/IncubatorReleases/NOTICE
new file mode 100644
index 0000000..1af6878
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/NOTICE
@@ -0,0 +1,8 @@
+Apache Training Navigating ASF Incubation
+Copyright 2019 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (http://www.apache.org/).
+
+This product was original developed by
+Justin Mclean, copyright 2019.
diff --git a/content/ApacheWay/IncubatorReleases/README.md
b/content/ApacheWay/IncubatorReleases/README.md
new file mode 100644
index 0000000..5bacb30
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/README.md
@@ -0,0 +1,82 @@
+
+# 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 ec [...]
+
+## 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.
+
+## 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.
+
+If you are are a lawyer, remove the IANAL attribute / line.
+
+## How to Build
+
+To install the needed dependencies on OSX 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:
+
+`target/generated-slides/index.html`
+
+Just open the `index.html` in a browser to view the slides.
+
+Some features require the slides to be viewed via a http/https url you can do
this by running:
+
+`mvn jetty:run-exploded`
+
+And goto `http://127.0.0.1:8080/index.html` in a browser to view.
+
+Some key shortcuts that may help you give a presentation:
+
+- Cursor keys and space can navigate the slides.
+- Press S will show speaker notes and a timer in a separate window.
+- Press F for full screen.
+- Press N for next slide or P for previous slide.
+- Press O (for overview) will show a slide map / overview.
+- Press B will black the screen.
+
+## (ASF only) How to Make a Release
+
+To remove the 3rd party dependencies in the release, clean, package and create
the needed signature files, run this :
+
+`release.sh <version>`
+
+Or you can manually make a release in the usual ASF way.
diff --git a/content/ApacheWay/IncubatorReleases/clean-deps.sh
b/content/ApacheWay/IncubatorReleases/clean-deps.sh
new file mode 100755
index 0000000..6e1d352
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/clean-deps.sh
@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# remove dependancies in tree
+rm -rf libs/third-party
diff --git a/content/ApacheWay/IncubatorReleases/install-deps.sh
b/content/ApacheWay/IncubatorReleases/install-deps.sh
new file mode 100755
index 0000000..c8702c6
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/install-deps.sh
@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+cd libs
+mkdir third-party
+cd third-party
+
+# Install ERD
+git clone git://github.com/BurntSushi/erd
+cd erd
+stack init
+stack build --system-ghc
+
+# Install Mermaid
+npm install mermaid.cli
+
+# Install PhantomJS
+wget https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-2.1.1-macosx.zip
+unzip phantomjs-2.1.1-macosx.zip
+
+# SVGBob
+#cargo install svgbob_cli
+
+# Syntrax
+pip install --upgrade syntrax
+pip install pycairo
+brew install pygobject3
+
+# Vega
+npm install vega
+
+# ImageMagic
+#wget
https://imagemagick.org/download/binaries/ImageMagick-x86_64-apple-darwin17.7.0.tar.gz
+#tar xvzf ImageMagick-x86_64-apple-darwin17.7.0.tar.gz
diff --git a/content/ApacheWay/IncubatorReleases/pom.xml
b/content/ApacheWay/IncubatorReleases/pom.xml
new file mode 100644
index 0000000..2d808af
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/pom.xml
@@ -0,0 +1,324 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0";
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd";>
+ <modelVersion>4.0.0</modelVersion>
+
+ <parent>
+ <groupId>org.apache</groupId>
+ <artifactId>apache</artifactId>
+ <version>21</version>
+ </parent>
+
+ <groupId>org.apache.training</groupId>
+ <artifactId>incubator-releases</artifactId>
+ <version>1.0.0-SNAPSHOT</version>
+ <packaging>war</packaging>
+
+ <name>How To Slide Your Release Past The Incubator</name>
+ <description>How to make making releases while your are an ASF incubating
project.</description>
+
+ <properties>
+ <project.main.contentfile>index</project.main.contentfile>
+
<project.slides.directory>${project.build.directory}/generated-slides</project.slides.directory>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+
<asciidoctor.maven.plugin.version>2.0.0-RC.1</asciidoctor.maven.plugin.version>
+ <asciidoctorj.version>2.0.0-RC.2</asciidoctorj.version>
+ <asciidoctorj.diagram.version>1.5.16</asciidoctorj.diagram.version>
+
<asciidoctorj.extensions-lab.version>1.0.0</asciidoctorj.extensions-lab.version>
+ <revealjs.version>3.7.0</revealjs.version>
+ <asciidoctor-revealjs.version>2.0.0</asciidoctor-revealjs.version>
+ </properties>
+
+ <build>
+ <plugins>
+ <!-- Check if all source files have the required apache license
headers -->
+ <plugin>
+ <groupId>org.apache.rat</groupId>
+ <artifactId>apache-rat-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>license-check</id>
+ <phase>verify</phase>
+ <goals>
+ <goal>check</goal>
+ </goals>
+ </execution>
+ </executions>
+ <configuration>
+ <consoleOutput>true</consoleOutput>
+ <excludes>
+ <!-- TODO: This is a mofified version of an
asciidoctor file ... nor sure we can stick an Apache Header on it -->
+ <exclude>libs/docinfo-hack/document.html.slim</exclude>
+
+ <!-- Maven related files -->
+ <exclude>**/target/**</exclude>
+
+ <!-- Eclipse related files -->
+ <exclude>**/.project</exclude>
+ <exclude>**/.settings/**</exclude>
+ <exclude>**/.classpath</exclude>
+
+ <!-- IntelliJ related files -->
+ <exclude>**/.idea/**</exclude>
+ <exclude>**/*.iml</exclude>
+
+ <!-- Asciidoctor generated files -->
+ <exclude>**/.asciidoctor/**</exclude>
+
+ <!-- JSON doesn't like comments -->
+ <exclude>**/*.json</exclude>
+ <!-- Mermaid does't like comments -->
+ <exclude>**/*.mmd</exclude>
+
+ <!-- Output of the profiler maven extension -->
+ <exclude>**/.profiler/**</exclude>
+ </excludes>
+ </configuration>
+ </plugin>
+
+ <plugin>
+ <groupId>com.googlecode.maven-download-plugin</groupId>
+ <artifactId>download-maven-plugin</artifactId>
+ <version>1.4.1</version>
+ <executions>
+ <execution>
+ <id>install-asciidoctor-revealjs</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>wget</goal>
+ </goals>
+ <configuration>
+
<url>https://github.com/asciidoctor/asciidoctor-reveal.js/archive/v${asciidoctor-revealjs.version}.zip</url>
+ <unpack>true</unpack>
+
<outputFileName>asciidoctor-reveal.js-${asciidoctor-revealjs.version}.zip</outputFileName>
+
<outputDirectory>${project.build.directory}</outputDirectory>
+ </configuration>
+ </execution>
+ <execution>
+ <id>install-revealjs</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>wget</goal>
+ </goals>
+ <configuration>
+
<url>https://github.com/hakimel/reveal.js/archive/${revealjs.version}.zip</url>
+ <unpack>true</unpack>
+
<outputFileName>reveal.js-${revealjs.version}.zip</outputFileName>
+
<outputDirectory>${project.slides.directory}</outputDirectory>
+ </configuration>
+ </execution>
+ <execution>
+ <id>download-c3-css</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>wget</goal>
+ </goals>
+ <configuration>
+
<url>https://cdnjs.cloudflare.com/ajax/libs/c3/0.6.12/c3.min.css</url>
+
<outputDirectory>${project.slides.directory}/css</outputDirectory>
+ </configuration>
+ </execution>
+ <execution>
+ <id>download-c3-js</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>wget</goal>
+ </goals>
+ <configuration>
+
<url>https://cdnjs.cloudflare.com/ajax/libs/c3/0.6.12/c3.min.js</url>
+
<outputDirectory>${project.slides.directory}/js</outputDirectory>
+ </configuration>
+ </execution>
+ <execution>
+ <id>download-d3-js</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>wget</goal>
+ </goals>
+ <configuration>
+
<url>https://cdnjs.cloudflare.com/ajax/libs/d3/5.7.0/d3.min.js</url>
+
<outputDirectory>${project.slides.directory}/js</outputDirectory>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-resources-plugin</artifactId>
+ <version>3.1.0</version>
+ <executions>
+ <execution>
+ <id>copy-resources</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>copy-resources</goal>
+ </goals>
+ <configuration>
+
<outputDirectory>${project.build.directory}</outputDirectory>
+ <resources>
+ <!-- Copy the normal resources into the root
of the slides directory -->
+ <resource>
+ <directory>src/main/resources</directory>
+
<targetPath>${project.slides.directory}</targetPath>
+ </resource>
+ <!-- Copy our css-theme to the reveal.js theme
directory -->
+ <resource>
+ <directory>src/main/theme</directory>
+ <filtering>true</filtering>
+
<targetPath>${project.slides.directory}/reveal.js-${revealjs.version}/css/theme</targetPath>
+ </resource>
+ <!-- Patch one of the "slim" files as the
'docinfo' integration doesn't seem to work -->
+ <resource>
+ <directory>libs/docinfo-hack</directory>
+
<targetPath>${project.build.directory}/asciidoctor-reveal.js-${asciidoctor-revealjs.version}/templates</targetPath>
+ </resource>
+ </resources>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ <plugin>
+ <groupId>org.asciidoctor</groupId>
+ <artifactId>asciidoctor-maven-plugin</artifactId>
+ <version>${asciidoctor.maven.plugin.version}</version>
+ <executions>
+ <execution>
+ <id>generate-slides</id>
+ <phase>process-resources</phase>
+ <goals>
+ <goal>process-asciidoc</goal>
+ </goals>
+ <configuration>
+ <!-- Tell asciidoctor to use the reveal.js backend
and not the default html -->
+ <backend>revealjs</backend>
+ <!-- Configure where are all the asciidoc source
files located -->
+
<sourceDirectory>src/main/asciidoc</sourceDirectory>
+ <!-- Configure the target director to where will
the output be generated -->
+
<outputDirectory>${project.slides.directory}</outputDirectory>
+ <!-- Enable optional modules for generating
diagrams and charts -->
+ <requires>
+ <require>asciidoctor-diagram</require>
+ <!--require>chart-block-macro</require-->
+ </requires>
+ <!-- This has to point to the asciidoctor-revealjs
directory which contains all the "slim" files -->
+
<templateDir>${project.build.directory}/asciidoctor-reveal.js-${asciidoctor-revealjs.version}/templates</templateDir>
+ <attributes>
+ <!--imagesdir></imagesdir-->
+ <!--
+ Tell the system the relative path to the
reveal.js files
+ inside the generated-slides directory.
+ -->
+
<revealjsdir>reveal.js-${revealjs.version}</revealjsdir>
+ <!--
+ Use our custom theme, which is defined by
src/main/theme/apache.css
+ and copied inside the reveal.js
installation by the resources plugin a few lines
+ up inside this pom.
+ -->
+ <revealjs_theme>apache</revealjs_theme>
+ <!-- Some basic settings -->
+
<revealjs_transition>linear</revealjs_transition>
+
<project-version>${project.version}</project-version>
+
<source-highlighter>highlightjs</source-highlighter>
+
<!--highlightjs-theme>https://raw.githubusercontent.com/isagalaev/highlight.js/master/src/styles/arduino-light.css</highlightjs-theme-->
+
<erd>${basedir}/libs/third-party/erd/.stack-work/dist/x86_64-osx/Cabal-2.2.0.1/build/erd/erd</erd>
+
<!--convert>${basedir}/libs/third-party/ImageMagick-7.0.8/bin/convert</convert>
+
<identify>${basedir}/libs/third-party/ImageMagick-7.0.8/bin/identify</identify-->
+
<mermaid>${basedir}/libs/third-party/node_modules/.bin/mmdc</mermaid>
+
<phantomjs>${basedir}/libs/third-party/phantomjs-2.1.1-macosx/bin/phantomjs</phantomjs>
+
<vg2svg>${basedir}/libs/third-party/node_modules/.bin/vg2svg</vg2svg>
+ </attributes>
+ </configuration>
+ </execution>
+ </executions>
+ <dependencies>
+ <dependency>
+ <groupId>org.asciidoctor</groupId>
+ <artifactId>asciidoctorj</artifactId>
+ <version>${asciidoctorj.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>org.asciidoctor</groupId>
+ <artifactId>asciidoctorj-diagram</artifactId>
+ <version>${asciidoctorj.diagram.version}</version>
+ </dependency>
+ <!--dependency>
+ <groupId>org.asciidoctor</groupId>
+ <artifactId>asciidoctorj-extensions-lab</artifactId>
+
<version>${asciidoctorj.extensions-lab.version}</version>
+ <!- Referenced locally till it's officially released ->
+ <scope>system</scope>
+
<systemPath>${basedir}/libs/asciidoctorj-extensions-lab-${asciidoctorj.extensions-lab.version}.jar</systemPath>
+ </dependency-->
+ </dependencies>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-war-plugin</artifactId>
+ <version>3.2.2</version>
+ <configuration>
+ <failOnMissingWebXml>false</failOnMissingWebXml>
+
<warSourceDirectory>${project.build.directory}/generated-slides</warSourceDirectory>
+ </configuration>
+ </plugin>
+ <plugin>
+ <groupId>org.eclipse.jetty</groupId>
+ <artifactId>jetty-maven-plugin</artifactId>
+ <version>9.4.14.v20181114</version>
+ </plugin>
+ <plugin>
+ <groupId>com.coderplus.maven.plugins</groupId>
+ <artifactId>copy-rename-maven-plugin</artifactId>
+ <version>1.0</version>
+ <executions>
+ <execution>
+ <id>rename-slide-file</id>
+ <phase>process-resources</phase>
+ <goals>
+ <goal>rename</goal>
+ </goals>
+ <configuration>
+
<sourceFile>${project.slides.directory}/${project.main.contentfile}.revealjs</sourceFile>
+
<destinationFile>${project.slides.directory}/${project.main.contentfile}.html</destinationFile>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ <plugin>
+ <groupId>com.coderplus.maven.plugins</groupId>
+ <artifactId>copy-rename-maven-plugin</artifactId>
+ <version>1.0</version>
+ <executions>
+ <execution>
+ <id>rename-slide-file</id>
+ <phase>process-resources</phase>
+ <goals>
+ <goal>rename</goal>
+ </goals>
+ <configuration>
+
<sourceFile>${project.slides.directory}/${project.main.contentfile}.revealjs</sourceFile>
+
<destinationFile>${project.slides.directory}/${project.main.contentfile}.html</destinationFile>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+</project>
diff --git a/content/ApacheWay/IncubatorReleases/release.sh
b/content/ApacheWay/IncubatorReleases/release.sh
new file mode 100755
index 0000000..c4156d3
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/release.sh
@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+if [ $# -eq 0 ]
+then
+ version="1.0"
+else
+ version=$1
+fi
+
+file="apache-training-navigating-ASF-incubation-$version-incubating.tar.gz"
+
+./clean-deps.sh
+mvn clean
+tar -zcvf ${file} .
+shasum -a 512 ${file} > ${file}.sha512
+gpg --armor --output ${file}.asc --detach-sig ${file}
diff --git a/content/ApacheWay/IncubatorReleases/src/main/asciidoc/aboutme.adoc
b/content/ApacheWay/IncubatorReleases/src/main/asciidoc/aboutme.adoc
new file mode 100644
index 0000000..6cd9b40
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/src/main/asciidoc/aboutme.adoc
@@ -0,0 +1,20 @@
+////
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+////
+
+* TODO Fill in your own your info here
\ No newline at end of file
diff --git a/content/ApacheWay/IncubatorReleases/src/main/asciidoc/index.adoc
b/content/ApacheWay/IncubatorReleases/src/main/asciidoc/index.adoc
new file mode 100644
index 0000000..ca703bf
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/src/main/asciidoc/index.adoc
@@ -0,0 +1,409 @@
+////
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+////
+
+== How To Slide Your Release Past The Incubator
+:description: 50 minute talk on how to create incubator releases
+:keywords: Apache Way,Incubator,Releases
+:author: Your Name
+:email: Your email
+:position: Your Job title
+:IANAL: I am not a lawyer
+{author} +
+{position} +
+{email} +
+
+image::ApacheLogo.png[]
+
+== Who am I?
+include::aboutme.adoc[]
+
+ifdef::IANAL[]
+== I am not a Lawyer
+* I’m not a lawyer, and nothing on these sides is legal advice
+* Occasionally I get things wrong
+* My understanding has changed over time
+* Sometimes it’s complex, and there’s more than one “right” answer
+* I’m a volunteer and not paid to do this. Not even by my day job
+* This talk contains my views and may not represent the incubator as a whole
+endif::[]
+
+== What is the Apache Incubator?
+* Where communities come to learn the Apache Way
+* Likes existing projects with a community around them
+* Main entry point for new projects
+
+== Why we Have an Incubating Process?
+* Podling follows the Apache Way
+* Ensure donations comply with the Apache 2.0 license
+* Podling follows the ASF structure of contributors, committers and PMC members
+* Podling grants more responsibility via meritocracy
+* Ensure that decision making is done in the open
+* People act as individuals, not the company they work for
+
+== The Apache Way
+* Charity - For the public good. Software costs nothing
+* Pragmatic - Business friendly
+* Community - Collaboration, consensus and diversity
+* Merit - The more you do you more responsibility you have. Not just code
contributions
+* Open - Everything in the public view. Discussions occur on mailing lists.
Everyone can participate
+* Consensus - Work together to find ways forward
+
+== Apache License
+* Permissive license - you can do what you want
+* Business friendly - can be used for commercial projects
+* Requires source headers, a LICENSE and (optionally) a NOTICE file
+* If your are not an ASF project:
+** You don’t need to publish the source
+** You don’t have to give back to the project
+** You don’t need to ask for permission to use
+
+== State of Play
+* {podlings} projects in the incubator
+* {IPMCs} IPMC members (but not all are active)
+* Projects usually stay around 2 years in the incubator
+* A dozen or more successful releases a month
+* About 70% of releases pass the incubator
+
+== Source Releases
+* Must be cryptographically signed
+* Must have an incubating disclaimer
+* Have LICENSE and NOTICE file that follow Apache policy
+* Follow licensing terms of any 3rd party bundled software
+* 3rd party files are compatible with the Apache license
+* Source files have ASF headers
+* Contain source code and no compiled code
+
+== Incubator Vote Process
+* Podling creates a release candidate
+* Vote on dev mailing list until 3 +1 votes and more +1 than -1
+* If vote fails need to make a new release candidate
+* Vote on incubator general mailing list
+* Need 3 +1 and more +1 than -1 by IPMC members
+* If vote fails need to make a new release candidate
+* Can release once vote passes and 72 hours pass
+
+== Why Your Release May Get a -1
+* Unexpected binary in the source release
+* Includes Category X licensed software (usually GPL)
+* Included Category B license software
+* LICENSE or NOTICE issue
+* Copyright issue
+* Missing license header or header issue
+* Contains encryption software
+
+== Representative Voting
+image::VoteData.png[votedata,500]
+
+== -1 is Not a Veto
+* Release votes need 3 +1 votes and more +1 than -1 votes to pass
+* Only IPMC votes are binding but good to take notice of other votes
+* People can change their minds and vote again
+* People can put up conditional votes
+* That being said a -1 vote is often for a good reason
+
+== It Doesn’t Have to be Perfect
+* Incubating projects are not expected to get it right the first time
+* May not be familiar with policy at the start
+* Policy doesn't cover all situations
+* Different projects may do things in different ways, policies are in most
cases guidance
+* A release containing no surprises is a good thing
+
+== Make it Easy to Review
+* Don’t make people have to think hard about it
+* Provide well-named artefacts
+* Don’t try to be smart with licensing or headers
+* Include compile instructions in the release
+* Make it easy to compile
+
+== There's Not One Right Answer
+* Documentation can sometimes be confusing and sometimes out of date
+* Some cultural knowledge isn’t well documented
+* Large IPMC and some differing opinions on what is “correct”
+* Often multiple ways to solve the same issue
+* If in doubt err on the side of caution - often changes needed are minimal
+
+== Top Level Projects As Examples
+* Policy changes over time / may be out of date
+* A project may have its own reasons for doing something in a certain way
+* Take care when looking at TLPs for examples
+* Probably better to look at TLPs that have recently graduated
+
+== Cryptographic Signing
+* Release must be cryptographically signed
+* Keys need to be RSA with at least 4096 bits
+* Good idea to use an apache.org email address
+* Use sha256 or sha512 for hash
+
+== Disclaimer
+* Best to put in a file called DISCLAIMER
+* Could also be in README
+
+== Tagging
+* Good idea to tag releases
+* That way that can be easily compared to what is released
+* Can also be easily checked out and built if needed in the future
+* Note that git tags can be changed so provide hash in vote email
+
+== Licensing
+* Seems where a lot of the issues occur
+* Observed some reluctance to understand
+* Language barrier to even those who speak English
+* Can be complex
+* ASF Policy does change over time
+
+== Legal vs Policy
+* Licenses provide certain legal obligations you need to comply with
+* Apache policy adds a little more:
+** Need to have NOTICE file
+** List all licenses in LICENSE (even if it's not required)
+
+== Developers vs Licensing
+* We’re not the only people who have difficulty or frustration with licensing
+* Apache projects tend to be on average a lot better!
+* External projects often:
+** Have unclear licenses
+** Include code under a different, sometimes incompatible, licenses
+** If Apache 2.0 licensed are missing a NOTICE file
+** Try to use funny licenses
+
+=== 33 Copies of BSD
+video::33BSD.mp4[]
+
+=== WTF Intel Lawyers
+video::wtf.mp4[]
+
+=== Only Dead People
+video::deadpeople.mp4[]
+
+=== GPL or BSD?
+video::both.mp4[]
+
+== Documentation Issues vs Errors
+* It’s better to have a documentation issue than a licensing error
+* Minor issues are OK to be fixed in the next release
+* If you're unsure a license should be listed
+
+== Universal Donor
+* Give anyone confidence they can use our software without any legal issues
+* All software within an artefact is compatible with the Apache 2.0 licence
+* Means it can be used for commercial and non-commercial purposes
+
+== Guiding Principle
+* The LICENSE and NOTICE files accurately represent the contents of the
distribution they belong to
+* Don't mention stuff that's not include in the release
+* There's need to mention external dependencies in LICENSE and NOTICE
+* Applies to both source and binary artefacts
+
+== May Contain Nuts
+* When bundling software check to see what it contains
+* In particular look for Category B and Category X software
+* Look at photos or other resources like fonts that you may not have
permissions to distribute or may be under another license
+* Manual inspection is not always required but often a good idea
+
+== Rat
+* Great tool for finding binaries and licenses in your source release
+* Not perfect but very handy
+* Will not find double headers
+* Will not check for multiple licenses in the same file
+* Only knows about a few licenses
+* Exclusions can be too wide and miss something
+
+== Rat Output
+image::rat.png[]
+
+== Finding Licenses
+* One way is to use find and grep +
+`find . -type f -exec grep -i "$1" {} \;`
+* Search for common license names “GPL”, “BSD”, “MIT”
+* Search for “copyright” piped to sort -u
+* Compare between releases
+
+== Pesky JS files
+* JS files, especial minified ones, are often missing license headers or
license details
+* Some license require full text to be contained somewhere
+* Lots are under non-Apache licenses including GPL
+* Other included other bundled software e.g. jQuery and Bootstrap
+* Licenses change between versions
+* Take care!
+
+== Other People’s Cat Photos
+* Copy all the images! +
+`find . -name "*.jpg" -exec cp {} images \;`
+* View all images using OS or favourite image browsing tool
+* If you find something that may be suspect:
+** Look at image metadata
+** Google reverse image search
+
+== Troublesome Fonts
+* Licensing around fonts can be complex
+* Look at font meta-data
+* Make sure you have permission to distribute
+* As fonts are binary may not be evident to the reviewer how they are licensed
+* You may want to make that clear in the LICENSE file
+
+== License File
+* License file named LICENSE or LICENSE.txt in the root directory
+* Contains Apache license and list of licenses of bundled software in a
distribution
+* Short form pointer to license preferred
+* May have different contents for source and binary
+
+== License File
+image::LICENSE.png[]
+
+== Notice File
+* Contains ASF copyright and developed at the ASF notice
+* Keep year up to date
+* Only add what is needed
+** Relocated copyright notices
+** Required notices from bundled Apache software notice files
+** All other required notices
+* In general licensing info shouldn’t be in the notice file
+
+== Notice file
+image::NOTICE.png[]
+
+== Required Notices
+* Some confusion to what to what a required notice is
+* Advertising clauses (but are probably category X)
+* Link to the source / how to get original
+* State changes made
+* Not copyright notice
+
+== Category A
+* Can bundle software and can depend on
+* Doesn’t add any restrictions above and beyond what the Apache License 2.0
does
+* Common licenses include: +
+Apache License 2.0, Apache License 1.1, 2 or 3 clause BSD (without advertising
clause), MIT/X11, W3C, Unicode, CC copyright only
+
+== Category B
+* Probably can’t include in a source release
+* Contain some restriction of use
+* May be able to use the binary form to limit the chance of corruption
+* Common license include: +
+Common Development and Distribution License (CDDL), Eclipse Public License
(EPL), Mozilla Public License (MPL), most Creative Common licenses
+
+== Category X
+* Can’t depend on
+* Can’t bundle software
+* A few exceptions for build tools and optional dependencies
+* Common Category X include: +
+GPL, LGPL, CC non commercial, JSON, BSD 4 clause, Apache 1.0?
+
+== No Unexpected Binary Files
+* No compiled source in a source release
+* No exes, dlls, jars or class files please
+* No minified JS without source
+
+== Headers
+* All Apache licensed source files should have an ASF header
+* Don’t include a copyright line
+* Use correct header
+
+== Can Compile From Code
+* Helps to have clear instructions on how to in the release
+* If it doesn’t work on a platform, please note that
+* If you need to install a 3rd party component to get it to compile, please
note that
+* Make it easy to compile
+
+== Apache Wombat
+* Fictional Apache project bundling Bootstrap 3.3.2
+* Showing how to assemble LICENSE and NOTICE
+* Github with explanation and check-in step by step showing changes +
+https://github.com/justinmclean/ApacheWombat
+* Short screencast (5 minutes) video of assembly +
+https://vimeo.com/171210141
+
+== Wombat Walk Through
+* Get boilerplate LICENSE and NOTICE files via curl
+* Get NOTICE file to correct copyright and year
+* Add Bootstrap’s MIT license to LICENSE
+* index.html contains HTML shiv which is dual licensed MIT/GPL
+* Add HTML shiv MIT to LICENSE
+* index.html depends on Respond.js and jQuery but not bundled
+* Bootstrap bundles normalize.js add MIT to LICENSE
+* Glyphicon fonts are MIT license add to LICENSE
+
+== Nice to Haves
+* Up to date README
+* Up to date CHANGES
+* KEYS file published
+* list of DEPENDENCIES
+
+== Common Mistakes
+* Unexpected binary files in the source release
+* Contents of LICENSE and NOTICE files
+* Source and binary have same LICENSE and NOTICE
+* Release not in the correct place
+* Missing DISCLAIMER
+* Missing headers
+* Issues missed due to Rat exclusions
+* Issues missed due to automation
+
+== Binary Distributions
+* Not considered an official release
+* Need to comply the same way with policies as source distributions
+* LICENSE and NOTICE may be different as the content of the release is often
different from the source release
+
+== Where to Ask for Help
+* Ask on your mailing lists
+* Ask your mentors
+* Email the incubator mailing list at: +
[email protected]
+* Email the legal discuss mailing list at: +
[email protected]
+
+== The Incubator is Broken
+* Every few years this comes up, I don't think it is, but like most things,
it's not perfect
+* It does add a lot of value for a relatively small amount of work for those
involved
+* Follow the general list and see what issues incubating projects do/don't run
into
+* We could do with more help. Get involved! You don't have to be an ASF member
+* We need more people reviewing releases and helping improve documentation
+
+== How can we improve?
+Please email the incubator mailing list at: +
[email protected]
+We’re happy to talk about it. Perhaps a bit too much :-)
+
+== Questions?
+Ask now, see me after the session, or email me, Your Name at Your email.
+
+== Useful Tools
+* Apache Creadur project (Rat + more) +
+http://creadur.apache.org
+* Apache Whisker - describes licenses via meta data +
+http://creadur.apache.org/whisker/
+* Release checklist +
+http://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist
+* Fossology +
+http://www.fossology.org
+
+== Useful Links
+* Legal previously asked questions +
+http://www.apache.org/legal/resolved
+* Incubator release process (DRAFT) +
+http://incubator.apache.org/guides/releasemanagement.html
+http://incubator.apache.org/guides/release.html
+* Assembling License and Notice How To +
+http://www.apache.org/dev/licensing-howto.html
+
+== Useful Links (cont)
+* Apache Maturity Model +
+http://community.apache.org/apache-way/apache-project-maturity-model.html
+* Legal mailing list archive +
+http://mail-archives.apache.org/mod_mbox/www-legal-discuss/
+* Legal JIRA +
+https://issues.apache.org/jira/browse/LEGAL
+* Software Licenses in Plain English +
+http://tldrlegal.com
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/asciidoc/projectstats.adoc
b/content/ApacheWay/IncubatorReleases/src/main/asciidoc/projectstats.adoc
new file mode 100644
index 0000000..7f61f49
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/src/main/asciidoc/projectstats.adoc
@@ -0,0 +1,26 @@
+
+////
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+////
+
+:pmcs: 203
+:ipmcs: 298
+:ipmc_chair: Justin Mclean
+:podlings: 49
+:members: 766
+:committers: 6926
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/33BSD.mp4
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/33BSD.mp4
new file mode 100755
index 0000000..ab89a14
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/33BSD.mp4 differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/ApacheLogo.png
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/ApacheLogo.png
new file mode 100644
index 0000000..61bc612
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/ApacheLogo.png
differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/IncubatingProjects.png
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/IncubatingProjects.png
new file mode 100644
index 0000000..baad03c
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/IncubatingProjects.png
differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/LICENSE.png
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/LICENSE.png
new file mode 100755
index 0000000..48a5983
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/LICENSE.png
differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/NOTICE.png
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/NOTICE.png
new file mode 100755
index 0000000..28e5f22
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/NOTICE.png
differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/VoteData.png
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/VoteData.png
new file mode 100644
index 0000000..3950ab3
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/VoteData.png
differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/both.mp4
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/both.mp4
new file mode 100755
index 0000000..f31da9b
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/both.mp4 differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/deadpeople.mp4
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/deadpeople.mp4
new file mode 100755
index 0000000..54459d3
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/deadpeople.mp4
differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/rat.png
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/rat.png
new file mode 100755
index 0000000..345d5de
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/rat.png differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/small-feather.png
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/small-feather.png
new file mode 100644
index 0000000..43b76a7
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/small-feather.png
differ
diff --git
a/content/ApacheWay/IncubatorReleases/src/main/resources/images/wtf.mp4
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/wtf.mp4
new file mode 100755
index 0000000..db0cc97
Binary files /dev/null and
b/content/ApacheWay/IncubatorReleases/src/main/resources/images/wtf.mp4 differ
diff --git a/content/ApacheWay/IncubatorReleases/src/main/stats.py
b/content/ApacheWay/IncubatorReleases/src/main/stats.py
new file mode 100644
index 0000000..71a0d0e
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/src/main/stats.py
@@ -0,0 +1,75 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+# Generate statistics from whimsey JSON file to update slides
+# run ike so:
+# python3 stats.py > asciidoc/projectstats.adoc
+
+import urllib.request, json
+
+print("""
+////
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+////
+""")
+
+with
urllib.request.urlopen("https://whimsy.apache.org/public/committee-info.json";)
as url:
+ data = json.loads(url.read().decode())
+ pmcs = data["committees"]
+ count = 0
+ for committee in pmcs:
+ if pmcs[committee]["pmc"]:
+ count = count + 1
+ print(":pmcs: " + str(count))
+
+ ipmcs = pmcs["incubator"]["roster"]
+ print(":ipmcs: " + str(len(ipmcs)))
+
+ chair = pmcs["incubator"]["chair"]
+ for apachename in chair:
+ print(":ipmc_chair: " + str(chair[apachename]["name"]))
+
+with urllib.request.urlopen("https://whimsy.apache.org/public/pods-scan.json";)
as url:
+ pods = json.loads(url.read().decode())
+ print(":podlings: " + str(len(pods)))
+
+with
urllib.request.urlopen("https://whimsy.apache.org/public/member-info.json";) as
url:
+ data = json.loads(url.read().decode())
+ members = data["members"]
+ print(":members: " + str(len(members)))
+
+with
urllib.request.urlopen("https://whimsy.apache.org/public/public_ldap_people.json";)
as url:
+ data = json.loads(url.read().decode())
+ people = data["people"]
+ print(":committers: " + str(len(people)))
diff --git a/content/ApacheWay/IncubatorReleases/src/main/theme/apache.css
b/content/ApacheWay/IncubatorReleases/src/main/theme/apache.css
new file mode 100644
index 0000000..9f7df10
--- /dev/null
+++ b/content/ApacheWay/IncubatorReleases/src/main/theme/apache.css
@@ -0,0 +1,397 @@
+/*
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+*/
+
+section.has-light-background,
+section.has-light-background h1,
+section.has-light-background h2,
+section.has-light-background h3,
+section.has-light-background h4,
+section.has-light-background h5,
+section.has-light-background h6 {
+ color: #FFF;
+}
+
+/*********************************************
+ * GLOBAL STYLES
+ *********************************************/
+body {
+ background-size: cover;
+ background-color: #FFF;
+}
+
+.reveal {
+ font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
+ font-size: 34px;
+ font-weight: normal;
+ color: #222;
+}
+
+::selection {
+ color: #222;
+ background: #bee4fd;
+ text-shadow: none;
+}
+
+.reveal .slides>section,
+.reveal .slides>section>section {
+ line-height: 1.3;
+ font-weight: inherit;
+}
+
+/*********************************************
+ * HEADERS
+ *********************************************/
+.reveal h1,
+.reveal h2,
+.reveal h3,
+.reveal h4,
+.reveal h5,
+.reveal h6 {
+ margin: 0 0 20px 0;
+ color: #000;
+ font-family: Futura, "Trebuchet MS", Arial, sans-serif;
+ font-weight: 600;
+ line-height: 1.2;
+ letter-spacing: normal;
+ text-shadow: none;
+ word-wrap: break-word;
+}
+
+.reveal h1 {
+ font-size: 2.5em;
+}
+
+.reveal h2 {
+ font-size: 1.6em;
+}
+
+.reveal h3 {
+ font-size: 1.3em;
+}
+
+.reveal h4 {
+ font-size: 1em;
+}
+
+.reveal h1 {
+ text-shadow: none;
+}
+
+/*********************************************
+ * OTHER
+ *********************************************/
+.reveal p {
+ margin: 20px 0;
+ line-height: 1.3;
+}
+
+/* Ensure certain elements are never larger than the slide itself */
+.reveal img,
+.reveal video,
+.reveal iframe {
+ max-width: 95%;
+ max-height: 95%;
+}
+
+.reveal strong,
+.reveal b {
+ font-weight: bold;
+}
+
+.reveal em {
+ font-style: italic;
+}
+
+.reveal ol,
+.reveal dl,
+.reveal ul {
+ display: inline-block;
+ text-align: left;
+ margin: 0 0 0 1em;
+}
+
+.reveal ol {
+ list-style-type: decimal;
+}
+
+.reveal ul {
+ list-style-type: disc;
+}
+
+.reveal ul ul {
+ list-style-type: square;
+}
+
+.reveal ul ul ul {
+ list-style-type: circle;
+}
+
+.reveal ul ul,
+.reveal ul ol,
+.reveal ol ol,
+.reveal ol ul {
+ display: block;
+ margin-left: 40px;
+}
+
+.reveal dt {
+ font-weight: bold;
+}
+
+.reveal dd {
+ margin-left: 40px;
+}
+
+.reveal q,
+.reveal blockquote {
+ quotes: none;
+}
+
+.reveal blockquote {
+ display: block;
+ position: relative;
+ width: 70%;
+ margin: 20px auto;
+ padding: 5px;
+ font-style: italic;
+ background: rgba(0, 0, 0, 0.05);
+ box-shadow: 0 0 2px rgba(255, 255, 255, 0.2);
+}
+
+.reveal blockquote p:first-child,
+.reveal blockquote p:last-child {
+ display: inline-block;
+}
+
+.reveal q {
+ font-style: italic;
+}
+
+.reveal pre {
+ display: block;
+ position: relative;
+ width: 90%;
+ margin: 20px auto;
+ text-align: left;
+ font-size: 0.55em;
+ font-family: monospace;
+ line-height: 1.2em;
+ word-wrap: break-word;
+ box-shadow: 0 0 6px rgba(255, 255, 255, 0.3);
+}
+
+.reveal code {
+ font-family: monospace;
+}
+
+.reveal pre code {
+ display: block;
+ padding: 5px;
+ overflow: auto;
+ max-height: 400px;
+ word-wrap: normal;
+ background: #3F3F3F;
+ color: #DCDCDC;
+}
+
+.reveal table {
+ margin: auto;
+ border-collapse: collapse;
+ border-spacing: 0;
+}
+
+.reveal table th {
+ font-weight: bold;
+}
+
+.reveal table th,
+.reveal table td {
+ text-align: left;
+ padding: 0.2em 0.5em 0.2em 0.5em;
+ border-bottom: 1px solid;
+}
+
+.reveal table th[align="center"],
+.reveal table td[align="center"] {
+ text-align: center;
+}
+
+.reveal table th[align="right"],
+.reveal table td[align="right"] {
+ text-align: right;
+}
+
+.reveal table tr:last-child td {
+ border-bottom: none;
+}
+
+.reveal sup {
+ vertical-align: super;
+}
+
+.reveal sub {
+ vertical-align: sub;
+}
+
+.reveal small {
+ display: inline-block;
+ font-size: 0.6em;
+ line-height: 1.2em;
+ vertical-align: top;
+}
+
+.reveal small * {
+ vertical-align: top;
+}
+
+/*********************************************
+ * LINKS
+ *********************************************/
+.reveal a {
+ color: #42affa;
+ text-decoration: none;
+ -webkit-transition: color 0.15s ease;
+ -moz-transition: color 0.15s ease;
+ transition: color 0.15s ease;
+}
+
+.reveal a:hover {
+ color: #8dcffc;
+ text-shadow: none;
+ border: none;
+}
+
+.reveal .roll span:after {
+ color: #fff;
+ background: #068ee9;
+}
+
+/*********************************************
+ * IMAGES
+ *********************************************/
+.reveal section img {
+ margin: 15px 0;
+}
+
+.reveal a img {
+ -webkit-transition: all 0.15s linear;
+ -moz-transition: all 0.15s linear;
+ transition: all 0.15s linear;
+}
+
+.reveal a:hover img {
+ background: rgba(0, 0, 0, 0.2);
+ border-color: #42affa;
+ box-shadow: 0 0 20px rgba(0, 0, 0, 0.55);
+}
+
+/*********************************************
+ * NAVIGATION CONTROLS
+ *********************************************/
+.reveal .controls div.navigate-left,
+.reveal .controls div.navigate-left.enabled {
+ border-right-color: #42affa;
+}
+
+.reveal .controls div.navigate-right,
+.reveal .controls div.navigate-right.enabled {
+ border-left-color: #42affa;
+}
+
+.reveal .controls div.navigate-up,
+.reveal .controls div.navigate-up.enabled {
+ border-bottom-color: #42affa;
+}
+
+.reveal .controls div.navigate-down,
+.reveal .controls div.navigate-down.enabled {
+ border-top-color: #42affa;
+}
+
+.reveal .controls div.navigate-left.enabled:hover {
+ border-right-color: #8dcffc;
+}
+
+.reveal .controls div.navigate-right.enabled:hover {
+ border-left-color: #8dcffc;
+}
+
+.reveal .controls div.navigate-up.enabled:hover {
+ border-bottom-color: #8dcffc;
+}
+
+.reveal .controls div.navigate-down.enabled:hover {
+ border-top-color: #8dcffc;
+}
+
+/*********************************************
+ * PROGRESS BAR
+ *********************************************/
+.reveal .progress {
+ background: rgba(255, 255, 255, 0.2);
+}
+
+.reveal .progress span {
+ background: #42affa;
+ -webkit-transition: width 800ms cubic-bezier(0.26, 0.86, 0.44, 0.985);
+ -moz-transition: width 800ms cubic-bezier(0.26, 0.86, 0.44, 0.985);
+ transition: width 800ms cubic-bezier(0.26, 0.86, 0.44, 0.985);
+}
+
+/*********************************************
+ * SLIDE NUMBER
+ *********************************************/
+.reveal .slide-number {
+ color: #42affa;
+}
+
+.reveal .red {
+ color: red;
+}
+
+/*********************************************
+ * Footer and Header
+ *********************************************/
+
+.header {
+ position: relative;
+}
+
+.footer {
+ position: relative;
+}
+
+.footer .left {
+ position: absolute;
+ left: 20px;
+ bottom: 5px;
+ width: 40px;
+ height: 80px;
+ background-image: url(../../../images/small-feather.png);
+ background-repeat: no-repeat;
+ background-size: contain;
+}
+
+.footer .right {
+ position: absolute;
+ left: 80px;
+ bottom: 20px;
+ text-align: center;
+ width: 100%;
+}
\ No newline at end of file
diff --git
a/content/ApacheWay/NavigatingASFIncubation/src/main/asciidoc/index.adoc
b/content/ApacheWay/NavigatingASFIncubation/src/main/asciidoc/index.adoc
index 0b20346..2c818a3 100644
--- a/content/ApacheWay/NavigatingASFIncubation/src/main/asciidoc/index.adoc
+++ b/content/ApacheWay/NavigatingASFIncubation/src/main/asciidoc/index.adoc
@@ -133,7 +133,7 @@ image::IncubatingProjects.png[]
** You don’t need to ask for permission to use
== State of Play
-* {PMCs} projects in the incubator
+* {podlings} projects in the incubator
* {IPMCs} IPMC members (but not all are active)
* Projects usually stay 1 to 2 years in the incubator
* A dozen or so successful releases a month
