Hi all, I think this looks great. The only addition I'd make is to start with the change. Something along the lines of:
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're opening up commit access to all Apache committers. Just as a teaser to keep on reading. But I'm also fine without a tagline like that. On Tue, Sep 22, 2020 at 7:11 PM gautam gupta <[email protected]> wrote: > 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 > > > > >
