This is an automated email from the ASF dual-hosted git repository.
larsfrancke pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/incubator-training.git
The following commit(s) were added to refs/heads/develop by this push:
new 6c5de78 Comdev working groups, V1 (#99)
6c5de78 is described below
commit 6c5de78e1b4db3d20a1bbf3a90e79a657ec4a322
Author: Rich Bowen <[email protected]>
AuthorDate: Mon Sep 16 07:15:29 2024 -0400
Comdev working groups, V1 (#99)
---
.../WorkingGroups/src/main/asciidoc/index.adoc | 220 +++++++++++++++++++--
.../src/main/resources/images/ask-me.jpg | Bin 0 -> 4863770 bytes
.../src/main/resources/images/barn-raising.jpg | Bin 0 -> 137349 bytes
.../src/main/resources/images/cat-herding.jpg | Bin 0 -> 116874 bytes
.../src/main/resources/images/dive.jpg | Bin 0 -> 22341 bytes
.../src/main/resources/images/facebook.png | Bin 0 -> 122674 bytes
.../src/main/resources/images/fedora-badges.png | Bin 0 -> 130217 bytes
.../src/main/resources/images/reddit-badges.png | Bin 0 -> 9489 bytes
.../src/main/resources/images/shark.jpg | Bin 0 -> 141487 bytes
.../src/main/resources/images/twitter.png | Bin 0 -> 194367 bytes
.../src/main/resources/images/website.png | Bin 0 -> 257128 bytes
.../ComDev/WorkingGroups/src/main/theme/apache.css | 2 +-
12 files changed, 203 insertions(+), 19 deletions(-)
diff --git a/content/Apache/ComDev/WorkingGroups/src/main/asciidoc/index.adoc
b/content/Apache/ComDev/WorkingGroups/src/main/asciidoc/index.adoc
index 4191941..4059205 100644
--- a/content/Apache/ComDev/WorkingGroups/src/main/asciidoc/index.adoc
+++ b/content/Apache/ComDev/WorkingGroups/src/main/asciidoc/index.adoc
@@ -20,6 +20,8 @@
include::_settings.adoc[]
:presenter_name: Your Name Here
:presenter_company: Apache Software Foundation
+// 40 minutes - 5 minutes Q&A = 2100 seconds
+:revealjs_totalTime: 2100
== ComDev Working Groups
@@ -29,12 +31,16 @@ include::_settings.adoc[]
* Which ones have we started?
* How to get involved.
-== A bit about ComDev
+== !
-" ... charged with coordinating community development efforts."
+" ComDev is ... charged with coordinating community development efforts."
+
+image::cat-herding.jpg[]
[NOTE.speaker]
--
+Picture: "Cat herders" - signifying that coordinating community can be
+challenging.
* ComDev exists to help projects build their communties
* Yes, projects should do this themselves, but having common practices and
tools lowers the barrier
@@ -42,14 +48,20 @@ include::_settings.adoc[]
--
-== We are all ComDev
+== !
Key Point: ComDev does not do this work *for* you. It's a place
for everyone to **collaborate on best practices** and tools that
span all projects. Come join us.
+image::barn-raising.jpg[scalewidth=50%]
+++++
+<small>CC by Historic Bremen Indiana on Flickr</small>
+++++
+
[NOTE.speaker]
--
+Picture: A community building a barn together.
ComDev is the ideal place for people with so-called "non-technical"
skills that they want to contribute to the ASF.
@@ -66,29 +78,105 @@ before they get more deeply involved.
* working towards a common goal ...
* collaboratively, in public
-== Welcome
+== Each group has
-image::welcome.jpg[scaledwidth=50%]
+* Git repo - https://github.com/apache/comdev-working-groups
+* A narrowly-defined goal or mission
+
+[NOTE.speaker]
+--
+Narrowly defined so that there's no ambiguity, room for scope creep, or
+potential to overlap/conflict with other efforts.
+--
+== Why?
+
+After all, everyone knows that they can just dive in and start doing
+stuff, right?
+
+image::dive.jpg[]
++++
-<small>CC by "alborzshawn" on Flickr</small>
+<small>CC by "Noirin Shirley" on Flickr</small>
++++
+
[NOTE.speaker]
--
+Picture: Someone "diving in"
Yes, it's open source and "everyone knows" that they can come
-contribute. But people like to be asked. They like to be invited. They
+contribute. But it can still be intimidating. People don't know where to
+start.
+
+People like to be asked. They like to be invited. They
like to be welcomed.
-The working groups exist to give explicit welcome and permission to
-anyone who wants to participate. Come join us!
+We get email to the dev@community mailing list almost every week that
+asks "where I can get involved" and invariably someone says "Find a
+place and just start!" which is both true, and incredibly unhelpful.
+Working groups give a more focused answer "pick one of these."
+
+--
+
+== !
+
+And, let's be honest, sometimes we we aren't the most welcoming place.
+
+image::shark.jpg[scalewidth=35%]
+
+[NOTE.speaker]
+--
+Picture: Rich's kid with a shark (sometimes you don't want to dive in
+with the sharks)
+
+Having clearly defined places to do clearly defined work can lower the
+anxiety of joining something new.
--
+== !
+
+image::welcome.jpg[scaledwidth=50%]
+
+++++
+<small>CC by "alborzshawn" on Flickr</small>
+++++
+
+[NOTE.speaker]
+--
+Picture: A "welcome" sign.
+
+The working groups exist to give explicit welcome and *permission* to
+anyone who wants to participate.
+--
+
+== !
+
+image::ask-me.jpg[scalewidth=35%]
+
+[NOTE.speaker]
+--
+Picture: An "Ask me" badge from a long-ago ApacheCon
+
+Having a "title" (I'm a member of the
+Advisors working group!) gives people a feeling that they are authorized
+to speak with that voice. It gives *explicit permission*. It also
+encourages others to take them seriously ("oh, you're part of the
+working group")
+
+It also gives a structure within which to participate, and a recommended
+way to get started.
+
+--
+
+== Working groups so far
+
== wg-wg
* For discussion of cross-working-group norms, process, or tools
+* Purely advisory - WGs can do what they want - but wg-wg proposes
+ structure and processes.
+* Defines recommended way to start a new WG
[NOTE.speaker]
--
@@ -99,7 +187,7 @@ anyone who wants to participate. Come join us!
== wg-advisors
-* Advising projecdts and PMCs on best practice
+* Advising projects and PMCs on best practice
* Seasoned ASF members and community managers
* It's important to respect a project's autonomy
@@ -110,12 +198,25 @@ This is really no different from going to the project and
volunteering
your expertise, but having the working group emboldens pepole to do this
work.
+The primary goal is not so much to force people to do things a
+particular way, but to streamline it for people who don't know how to
+get started.
+
Ask first. You will probably be welcome, but don't assume. Be clear that
you're offering advice, but don't have standing to vote or enforce
-anything.
+anything. And once you've done this for a while, there's a chance that
+some projects will invite you to stick around.
--
+== wg-advisors, cont'd
+
+* Get involved if
+** You've been around the ASF a long time
+** You're a Community Manager or Developer Advocate in your "real life"
+** You have skills like metrics, doc writing, event planning or anything
+else that might be of value to an open source project
+
== wg-badging
image::fas-paranoid-panda.png[]
@@ -125,11 +226,49 @@ image::fas-paranoid-panda.png[]
[NOTE.speaker]
--
+Picture: An example badge from badges.fedoraproject.org
+--
+
+== !
+
+image::fedora-badges.png[]
+
+[NOTE.speaker]
+--
+Picture: Screenshot of badges.fedoraproject.org
-Concept based on the Fedora badging sysem - https://badges.fedoraproject.org/
+Concept based on the Fedora badging system - https://badges.fedoraproject.org/
+
+Badges could celebrate your first PR, your 100th closed issue, or your
+1000th email message. Or they could be event-based ("Attended Community
+Over Code Denver 2024")
--
+== !
+
+image::reddit-badges.png[scalewidth=50%]
+
+[NOTE.speaker]
+--
+Picture: screenshot of Reddit badges
+
+Worth noting that some people find this frivolous, or that it
+trivializes what we do. Other people like earning achievements,
+celebrating milestones, and trying new things.
+
+If you don't like this idea, then accept that it's not for you, and move
+on. You're not obliged to participate.
+
+--
+
+== Challenges
+
+* There used to be a variety of open source badging options. Most of
+ them have gone closed, or died out
+* Would probably want it integrated to some degree with participants'
+ ApacheID, which would require knowledge of how that works
+
== wg-code-of-conduct
* Providing a recommended template for project code of conduct
@@ -139,8 +278,8 @@ Concept based on the Fedora badging sysem -
https://badges.fedoraproject.org/
== wg-social
-* Orchestrating local gathering of Apache enthusiasts
* AKA Party Working Group
+* Orchestrating local **social** gathering of Apache enthusiasts
* See also ALC - Apache Local Communities - https://s.apache.org/alc
* Still in idea/startup stage
@@ -151,11 +290,46 @@ Concept based on the Fedora badging sysem -
https://badges.fedoraproject.org/
* Coordinate with M&P for consistent messaging
* Still in idea/startup stage
+== !
+image:facebook.png[]
+
+[.notes]
+--
+The Facebook page gets a lot of beginner questions, as well as a lot of
+spam. Having a rotation of people to handle this, be friendly,
+welcoming, and informative, as well as posting regular topical content,
+would be great.
+--
+
+== !
+image::twitter.png[]
+
+[.notes]
+--
+The official Twitter is handled by M&P, but there are several other
+Twitter handles (@apachecommunity, and many project handles) and there
+are other social media outlets where we do not have a presence, but
+probably should. You can help make that happen.
+--
+
== wg-website
-* Maintenance of the website
-** https://community.apache.org/
-* Yes, our website is objectively terrible. We know. Come help.
+
+image::website.png[]
+
+[NOTE.speaker]
+--
+Picture: Screenshot of community.apache.org
+
+Yes, our website is terrible. Please come help us.
+
+Needs:
+* Information architecture.
+* Design.
+* Navigation by audience.
+* Content creation.
+
+--
== wg-welcome
@@ -171,9 +345,14 @@ Concept based on the Fedora badging sysem -
https://badges.fedoraproject.org/
image::sample-answer.png[]
-== Sample answers
+[NOTE.speaker]
+--
+Picture: Screenshot of one of the sample answers
+--
-* Why?
+== Sample Answers
+
+* Why do we need sample answers?
** Consistent messaging
** Thorough, friendly answers with links
@@ -198,6 +377,11 @@ image::wg-email.png[scaledwidth=75%]
* Send email to [email protected]
* Use a Subject: line tag identifying the working group
+[NOTE.speaker]
+--
+Picture: Email headers showing how to communicate about working groups
+--
+
== Getting involved
* Show up
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/ask-me.jpg
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/ask-me.jpg
new file mode 100644
index 0000000..bdec3dc
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/ask-me.jpg
differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/barn-raising.jpg
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/barn-raising.jpg
new file mode 100644
index 0000000..a8266f5
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/barn-raising.jpg
differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/cat-herding.jpg
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/cat-herding.jpg
new file mode 100644
index 0000000..e7fd180
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/cat-herding.jpg
differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/dive.jpg
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/dive.jpg
new file mode 100644
index 0000000..1917fb8
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/dive.jpg differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/facebook.png
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/facebook.png
new file mode 100644
index 0000000..95d627a
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/facebook.png
differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/fedora-badges.png
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/fedora-badges.png
new file mode 100644
index 0000000..db1c2a2
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/fedora-badges.png
differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/reddit-badges.png
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/reddit-badges.png
new file mode 100644
index 0000000..3e72ece
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/reddit-badges.png
differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/shark.jpg
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/shark.jpg
new file mode 100644
index 0000000..dae302e
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/shark.jpg differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/twitter.png
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/twitter.png
new file mode 100644
index 0000000..4072684
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/twitter.png
differ
diff --git
a/content/Apache/ComDev/WorkingGroups/src/main/resources/images/website.png
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/website.png
new file mode 100644
index 0000000..803d9bd
Binary files /dev/null and
b/content/Apache/ComDev/WorkingGroups/src/main/resources/images/website.png
differ
diff --git a/content/Apache/ComDev/WorkingGroups/src/main/theme/apache.css
b/content/Apache/ComDev/WorkingGroups/src/main/theme/apache.css
index 89536b2..8fbf92d 100644
--- a/content/Apache/ComDev/WorkingGroups/src/main/theme/apache.css
+++ b/content/Apache/ComDev/WorkingGroups/src/main/theme/apache.css
@@ -55,9 +55,9 @@ body {
font-weight: 600;
line-height: 1.2;
letter-spacing: normal;
- text-transform: uppercase;
text-shadow: none;
word-wrap: break-word; }
+/* text-transform: uppercase; */
.reveal h1 {
font-size: 2.5em; }
