Hi all, so a little push on the infra list got the issue resolved ... now all Apache committers can commit to our repo. However this only works on gitbox ... on github it seems to not be possible to set this up.
So where should we post this? - members - comdev - incubator-general - ... - ??? Anyway ... So the final version of the email would then be: ------------------------------------------------------------- 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're opening up commit access to all Apache committers. 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. Note: It seems that we can only grant all committers commit access on gitbox and not on Github, so be sure to set our gitbox repo as "upstream" when trying to commit: https://gitbox.apache.org/repos/asf?p=incubator-training.git *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* Am 23.09.20, 21:44 schrieb "Christofer Dutz" <[email protected]>: Hi Lars, indeed this could be a nice intro to the email ... currently still waiting for the jira to be processed ... https://issues.apache.org/jira/browse/INFRA-20879?filter=-2 Chris Am 23.09.20, 18:51 schrieb "Lars Francke" <[email protected]>: 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 > > > > >
