Have to admit that I really like using git in presentations as well as coding. As Lars mentioned, I build my presentations in asciidoctor and use reveal.js to run it. Everything is fully automated.
The cool thing with this is, you can do tags, branches, diffs, Cherry-Picking etc. Especially when it comes to training material for multiple versions of a product, this comes in handy. And you are not tied to some proprietary service or tool for presenting. Chris Outlook fur Android<https://aka.ms/ghei36> herunterladen ________________________________ From: Dmitriy Pavlov <dpav...@apache.org> Sent: Monday, February 25, 2019 4:57:41 PM To: dev@training.apache.org Subject: Re: Content / Labs / Scope Hi, Let me share my experience here. Usually, I develop presentations using google docs (or google presentations). This engine allows cooperative work, allows to do changes from any machine I have (e.g. office or home). And only after all edits have been done, I export the presentation to MS format and use it to demonstrate results. I understand that this format may not be in favor in ASF, because these features are proprietary and no versioning is possible. But for me, it is the easiest way to complete presentation using any free time I have. For labs and labs solution Git is a quite obvious solution. Here we can create 1 repo per training and use, for example, branches for lab1 lab1+solution lab2, lab2+solution etc. Because labs usually are based on each other and is an iterative process of doing some complex (educational) application Sincerely, Dmitriy Pavlov вс, 24 февр. 2019 г. в 03:23, Lars Francke <lars.fran...@gmail.com>: > On Sat, Feb 23, 2019 at 7:31 PM Sharan Foga <sha...@apache.org> wrote: > > > > > > > On 2019/02/22 23:12:29, Lars Francke <lars.fran...@gmail.com> wrote: > > > During the DISCUSS and VOTE threads I tried to postpone any discussion > > > about the actual content and technical bits but now would be a great > time > > > to start. > > > > > > I know that Dmitriy was eager to get started and Christofer also > > explained > > > his workflow briefly. Maybe you could go into more detail? > > > Christofer demonstrated his own tooling to us and I really liked it. > This > > > could be a great start. > > > > > > I'm sorry this is going to be a bit longer and maybe a bit "rambling". > > Take > > > it as you will. I just needed to write it down once :) > > > > > > When we've done trainings so far they usually consist of a couple of > > things: > > > > > > * Slides (for us usually in Powerpoint) > > > * Whiteboard sessions (usually the most interesting parts because they > > > usually are the result of attendee feedback/questions) > > > * Labs (the actual content, things that attendees need to "solve"/do) > > > * Lab setup (especially for the larger distributed systems getting a > > > realistic setup of the tools itself for all attendees isn't trivia > > > > > > I'm sure I'm missing something. > > > > Thanks Lars - this is good. Off the top of my head a couple of things > came > > to mind - the first is testing (to see how much attendees have learned > and > > this could be linked to certification which I think was mentioned in one > of > > the threads) and the second was a way of collecting feedback about the > > training - so perhaps a survey > > > > Those are good points I didn't think of. > > Tests we have never done by choice but I see that people might be > interested in them and surveys are something that we probably should have > done ourselves a long time ago already. So: Definitely. > > > > > What should our scope be? > > > Our initial idea centered around Slides and Labs. It would be great to > > also > > > have something that makes the Labs setup easier but in our experience > > > that's pretty hard (e.g. corporate firewalls don't allow access to X or > > Y) > > > to make generic (that shouldn't stop us from trying!) > > > > > > Slides: > > > I'd love to have a workflow where I can design slides entirelly in > > > Asciidoc. That makes them easily versionable and composable. Should we > > > allow multiple formats? If we decide on a text-only format and someone > > > donates a bunch of courses in Powerpoint. Would we deny that? > > > > I think that we would want to accept contribution that is relevant. There > > may be an overhead to convert the content into a more generic format but > > that's doable especially if it encourages contributions. > > > > I assume you meant "any contribution"? > In general I agree but any binary format (e.g. Powerpoint - I'll call it > binary even though it's really XML now but it's pretty useless for what I'm > going to mention or PDF) has the problem that doing reviews is tedious to > impossible. There's no good way (I know of) to create diffs for example and > people on Linux are left out entirely for Powerpoint. > > I currently believe having "one true format" for all of them is a good idea > (I am happy to be convinced otherwise), maybe with a kind of "staging" area > of accepted contributons that have yet to be converted and are not coverd > by "quality guarantees". > > > > > > > > > > > Labs: > > > Similarly for Labs we've had a good experience with (e.g.) > > > https://antora.org/ which also allows to create documentation in > > Asciidoc > > > and create a website out of it. But there's lots of ideas on how to > > improve > > > this (e.g. Notebooks in Zeppelin) and it'll also be way different > > depending > > > on the training topic. > > > > > > Audience/Customizability/Composability > > > I would assume that our trainings will also be used by non-commercial > > folks > > > or people needing to give a training in-house at their companies. For > > them > > > a prepared "deck" with ASF branding is fine but others might want to > > > incorporate these slides into their own work (see the Legal thread) and > > > also compose their own out of smaller "components". > > > So for me a good thing would be if we produce smaller "chapters" of > > things > > > that can then be composed however one would like and to make our > product > > > customizabile (e.g. custom header, footer, background colors etc.) > > > > > > Apache vs. non-Apache // Product vs. non-product > > > I wouldn't want to limit us to Apache products. I don't see a reason > not > > to > > > also talk about 3rd party tools. Especially if they are tightly > > integrated > > > into the ecosystem (e.g. the ELK stack is often used alongside Hadoop). > > > > +1 I like the idea and it also could make our content valuable to others > > outside the ASF > > > > > > > > I also don't see a reason to only focus on single products. A training > > > could focus on "IoT" and cover lots of products. > > > > +1 this will also give the Apache projects visibility of others in the > > same domain. I'm not really sure how cross pollinated our projects are. > > > > > > > > In a similar vein it doesn't always have to be technical products. I've > > > already been approached from multiple people about "The Apache Way" > > > presentations. Now whether they make more sense in ComDev is to be > > decided. > > > Maybe Sharan can weigh in? > > > > I think Training would be a great place for managing the Apache Way > > content. In ComDev we've tried to gather and collate this type of content > > and have ended up with a page of different presentation slides. Each > person > > has a different spin on it - so creating something standard as a nice off > > the shelf template that anyone can use will be great. And I'm happy to > > ensure we maintain a link and communicate with ComDev regularly so > > potential contributors know about what we are doing here in Training. > > > > Okay, that's good! > As you said: There's a dozen of those out there now. > > Lars > > > > Thanks > > Sharan > > > > > > > > Thanks, > > > Lars > > > > > >
