Hey Chris, Your announcement mail is great. I just changed the opening line and added some formatting to highlight some sections. Please use it if you like it.
Thanks, Gautam Hi, We, the Apache Training PPMC, would like to tell you about an important update by which you can promote & train people on your Apache project. We at Apache build all sorts of great software. Some people even create training projects for Apache projects. With the enormous pace of most of the projects, it's almost impossible to keep training material up-to-date. And even if you might know a given project, preparing training material might be too much. Also, even if you are a great coder, whipping up cool presentations might not be your favourite thing to do. Apache Training was created especially to help with all of this. We created a framework for creating presentations in a coder friendly way with features like versioning, tagging etc. It is a RevealJS based presentation-framework using Asciidoctor; A Markdown-like format but with a lot more control over the output and additional features. The primary supported build system is Maven. However, if you prefer, you can also build your presentation with Ruby and Node.JS (The latter two are still experimental). The output is a Browser-based presentation with a dedicated speaker view, which also allows exporting your presentation into PDF format for distribution. We would like to make Apache Training the place you look first if you are in need of Apache related training or presentation material. As you probably know your projects best, who would be better suited to help with creating this material, if not you? *Important Update* That's why the Apache Training PPMC has turned on the commit permissions for all Apache committers. We trust that you will use these rights wisely. However, we do have one restriction: If you want to contribute to the fundamental presentation framework and the tooling, please use PRs. But when it comes to content, feel free to add and/or edit content for your projects inside the 'content' directory as you see fit. Please however exercise common sense about whether or not a PR is appropriate, when changing content that other people created. *Please see this link for samples* https://github.com/apache/incubator-training/tree/develop/content < https://github.com/apache/incubator-training/tree/develop/content> *Easy Steps to Create a Presentation* To get you started in no-time, we provide Maven archetypes for generating your presentation skeleton. In order to use this please just run: mvn archetype:generate -DarchetypeGroupId=org.apache.training -DarchetypeArtifactId=content-archetype -DarchetypeVersion=1.0.0 This will ask you for a group-id, artifact-id, version and a package-name and as soon as you have provided them, will generate your new presentation. To now build the presentation, change into the freshly created directory and run: mvn package You can then run your presentation by opening the following file in your browser: target/generated-slides/index.html We hope Apache Training will help you and your projects. *The Apache Training (incubating) PPMC* On Tue, Sep 22, 2020 at 9:40 AM Christofer Dutz <[email protected]> wrote: > So bringing things back together we now have: > > > > ------------------------------------------------------------------------------ > > Hi, > > We, the Apache Training PPMC, would like to tell you about the Apache > Training (incubating) project. > > We at Apache build all sorts of great software. Some people even create > training projects for Apache projects. > With the enormous pace of most the projects, it's almost impossible to > keep training material up-to-date. > And even if you might know a given project, preparing training material > might be too much. > Also, even if you are a great coder, whipping up presentations might not > be your favourite thing to do. > > Apache Training was created especially to help with all of this. > > We created a framework for simply writing presentations in a way they can > be easily created, versioned, branched, tagged whatsoever. > It's generally a RevealJS based presentation-framework using Asciidoctor > (A Markdown-like format but with a lot more control over the output and > additional features). > The primary supported build system is Maven. However, if you prefer, you > can also build your presentation with Ruby and Node.JS (The latter two are > still experimental). > > The output is a Browser-based presentation with a dedicated speaker view, > which also allows exporting your presentation into PDF format for > distribution. > > We would like to make Apache Training the place you look first if you are > in need of Apache related training or presentation material. > > As you probably know your projects best, who would be better suited to > help with creating this material, if not you? > > That's why the Apache Training PPMC has turned on the commit permissions > for all Apache committers. > > We trust that you will use these rights wisely. However, we do have one > restriction: > If you want to contribute to the fundamental presentation framework and > the tooling, please use PRs. > But when it comes to content, feel free to add and/or edit content for > your projects inside the 'content' directory as you see fit. > Please however exercise common sense about whether or not a PR is > appropriate, when changing content that other people created. > > Please see: > https://github.com/apache/incubator-training/tree/develop/content < > https://github.com/apache/incubator-training/tree/develop/content> > For examples. > > To get you started in no-time, we provide Maven archetypes for generating > your presentation skeleton. > In order to use this please just run: > > mvn archetype:generate -DarchetypeGroupId=org.apache.training > -DarchetypeArtifactId=content-archetype -DarchetypeVersion=1.0.0 > > This will ask you for a group-id, artifact-id, version and a package-name > and as soon as you have provided them, will generate your new presentation. > > To now build the presentation, change into the freshly created directory > and run: > > mvn package > > You can then run your presentation by opening the following file in your > browser: > > target/generated-slides/index.html > > We hope Apache Training will help you and your projects. > > The Apache Training (incubating) PPMC > > > > > > > > Am 22.09.20, 17:18 schrieb "Sönke Liebau" <[email protected] > .INVALID>: > > Perfect! > > On Tue, 22 Sep 2020 at 17:14, Christofer Dutz < > [email protected]> wrote: > > > > Sure ... sounds like a good idea. > > > > Wasn't a full sentence anyway ... so how about this? > > > > "But when it comes to content, feel free to add and/or edit content > for your projects inside the 'content' directory as you see fit. > > Please however exercise common sense about whether or not a PR is > appropriate, when changing content that other people created" > > > > Chris > > > > > > Am 22.09.20, 17:10 schrieb "Sönke Liebau" < > [email protected]>: > > > > Thanks Chris, sounds great!! > > > > One thing that came to mind while reading, and this is just > thinking > > out loud, not a full blown suggestion: > > > > "But when it comes to content, feel free to add and/or edit your > > projects under as you want:" > > Should we add a sentence to please exercise common sense about > whether > > or not a PR is appropriate, when changing content that other > people > > created? > > > > Best regards, > > Sönke > > > > > > On Tue, 22 Sep 2020 at 12:39, Justin Mclean < > [email protected]> wrote: > > > > > > Hi, > > > > > > I correct a few minor English things, hope you don’t mind. > > > > > > Hi, > > > > > > We, the Apache Training PPMC, would like to tell you about the > Apache Training (incubating) project. > > > > > > We at Apache build all sorts of great software. Some people > even create training projects for Apache projects. > > > With the enormous pace of most the projects, it's almost > impossible to keep training material up-to-date. > > > And even if you might know a given project, preparing training > material might be too much. > > > Also, even if you are a great coder, whipping up presentations > might not be your favourite thing to do. > > > > > > Apache Training was created especially to help with all of > this. > > > > > > We created a framework for simply writing presentations in a > way they can be easily created, versioned, branched, tagged whatsoever. > > > It's generally a RevealJS based presentation-framework using > Asciidoctor (A Markdown-like format but with a lot more control over the > output and additional features). > > > The primary supported build system is Maven. However, if you > prefer, you can also build your presentation with Ruby and Node.JS (The > latter two are still experimental). > > > > > > The output is a Browser-based presentation with a dedicated > speaker view, which also allows exporting your presentation into PDF format > for distribution. > > > > > > We would like to make Apache Training the place you look first > if you are in need of Apache related training or presentation material. > > > > > > As you probably know your projects best, who would be better > suited to help with creating this material, if not you? > > > > > > That's why the Apache Training PPMC has turned on the commit > permissions for all Apache committers. > > > > > > We trust that you will use these rights wisely. However, we do > have one restriction: > > > If you want to contribute to the fundamental presentation > framework and the tooling, please use PRs. > > > But when it comes to content, feel free to add and/or edit > your projects under as you want: > > > > > > > https://github.com/apache/incubator-training/tree/develop/content < > https://github.com/apache/incubator-training/tree/develop/content> > > > > > > To get you started in no-time, we provide Maven archetypes for > generating your presentation skeleton. > > > In order to use this please just run: > > > > > > mvn archetype:generate -DarchetypeGroupId=org.apache.training > -DarchetypeArtifactId=content-archetype -DarchetypeVersion=1.0.0 > > > > > > This will ask you for a group-id, artifact-id, version and a > package-name and as soon as you have provided them, will generate your new > presentation. > > > > > > To now build the presentation, change into the freshly created > directory and run: > > > > > > mvn package > > > > > > You can then run your presentation by opening the following > file in your browser: > > > > > > target/generated-slides/index.html > > > > > > We hope Apache Training will help you and your projects. > > > > > > The Apache Training (incubating) PPMC > > > > > > > > -- > > Sönke Liebau > > Partner > > Tel. +49 179 7940878 > > OpenCore GmbH & Co. KG - Thomas-Mann-Straße 8 - 22880 Wedel - > Germany > > > > > -- > Sönke Liebau > Partner > Tel. +49 179 7940878 > OpenCore GmbH & Co. KG - Thomas-Mann-Straße 8 - 22880 Wedel - Germany > >
