Recap of April 12, 2018 meeting

Please note I didn’t attend this meeting and did my best to combine distilling with verbatim discussion. If anyone sees a need to change anything, please feel free to do so.

@juliekuehl: The first thing I want to say is that these weekly meetings don’t seem to be long enough to cover everything lately. We may need to explore something else to help get through all the changes we are in the middle of. It could be our blog over at https://make.wordpress.org/training/ or it could be another video meeting or it could be a series of screencasts or it could be more like a Contributor Day where we schedule a few hours to get together (perhaps by video) to get through several topics all at once. I don’t want to answer this today, but just raise the question so that we can think through options.
One hour hasn’t been enough!

So today’s agenda is:
1. Welcome
2. Discussion on verification workflow in GitHub
3. Discussion on lesson plan development in GitHub
4. Updates on other current projects
5. Open announcements/discussions

Discussion on verification workflow in GitHub

We have been moving our lesson plans from our Make site at https://make.wordpress.org/training/handbook/ to GitHub https://github.com/wptrainingteam.

WordPress Training Team

The WordPress training team creates downloadable lesson plans and related materials for instructors to use in live workshop environments.

URL
https://make.wordpress.org/training/

Repositories
121

All of the lesson plans have been migrated over, but not all of them have been verified that they are complete “copies” in GitHub.

The list at https://wptrainingteam.github.io/ is the complete list of lesson plans that were on Make and those with links are those that have been completely verified.

As you can see there’s a long list of lesson plans still needing verification.

@tmichellemoore: @juliekuehl Can you define complete copies? Does it mean it is the exact thing that was on the Make site?

@juliekuehl: It sounds simple, and it mostly is, but there are several steps to that process that aren’t well documented at this point.

@Lisa: Hey @juliekuehl what is the process of verification?

@juliekuehl: Complete copies means that all the spacing, icons, and as many images as we can recover have been duplicated on GitHub.

@Lisa: That’s what I need to document. It took me awhile to work out the process and there are several steps to it. I need to put together a screencast and a step-by-step document so that others can duplicate the process. That’s on me.

@Dess: Hi @juliekuehl I tested the Getting Started with WordPress Workshop https://docs.google.com/document/d/1Xm2DI0CtF-QKeb6uH8YCZSGmc8YCwscFASm1HrFBiaY/edit. Also translated it to Spanish

@juliekuehl: So for folks wanting to jump in and help with that process, know that nearly all the “how to help” documents right now probably aren’t accurate.

@Dess: I would like to help migrate that Workshop. And maybe we could also add a space for Spanish in Github?

@juliekuehl: @Dess, that’s terriffic! And also something we’re not quite sure what to do with at the moment. Translations aren’t something that we had considered, to be honest. Do you have any ideas on what that space in GitHub would look like? A branch of the lesson plan?

@bethsoderberg: We’ve always wanted to enable translations, I think a branch would make total sense.

@Dess: We could replicate the page in Spanish.

@Lisa: Isn’t there a translation plugin you can install to WordPress.

@pbrocks: Translations, I think need to be a branch. I should consult with the Docs team first before claiming that.

@juliekuehl: If we created new repos for each language it could get to be a nightmare. I would like to ask some of the other WP teams how they handle translations in GitHub.

@pbrocks will help getting first timers up to speed.

@juliekuehl: Good point @pbrocks!

I think there’s not much more we can resolve around the verification workflow at the moment.
This project is where that is being recorded FYI: https://github.com/orgs/wptrainingteam/projects/2

So lets move on to the second item on the agenda

Lesson Plan Development

That would be this project https://github.com/orgs/wptrainingteam/projects/3. @chetansatasiya asked if he could help and drafting lesson plans seemed like the best fit. So there are now 36 lesson plans in that project that have nothing but placeholder text in them. All of those are available for people to assign to themselves, fork, and start working on.

For anyone who wants to just ignore all this migration stuff and get on with what we do.

They are shown in no priority, but plugins would be the least important ones. If you choose to begin working on one, you can also drag it over to the Drafts column. @Dess, that might be where your Spanish version could come in

@juliekuehl: To my point that I started the meeting with, I am wondering if we should have “office hours” where new folks could stop by.

@tmichellemoore: @juliekuehl I think that would be great!

@juliekuehl: To do: document process by next week!

Current Projects

@juliekuehl: Our page at https://wptrainingteam.github.io/ is ugly, ugly, ugly.

@chetan200891 has shown interest in helping to make it better looking and probably more useful too. I have also asked the #design team to work their magic to come up with a plan for that. If they can design something, @chetan200891 is willing to build it out. He also found a tool that can help do that. Do you have that info @chetan200891? It would be using a Jekyll theme, which is supported by GitHub. https://jekyllrb.com/

@juliekuehl: We are on the design team’s Trello board, but they did not have their meeting this week.

@Lisa volunteered to help the design team

@juliekuehl: @Lisa, if you have ideas about the design, you’re welcome to work on it!

@juliekuehl: I’m just eyeballs deep in other stuff, so design isn’t going to be my thing right now.

@Lisa and @chetan200891 will work together to make that happen.

@juliekuehl: @chetan200891 to your point about GitHub, the bigger question is what would we want to use that integration for? Pull requests seems a good place to start.

@Lisa: Maybe explain what we do and join us? With new topic suggestions?

@juliekuehl: I think the best way to proceed here is to create a couple of blog posts regarding these possibilities.

Idea Period

@tmichellemoore: It would be nice if the integration could place a notification in this slack channel when a lesson is assigned and then when it moves to another lane in GitHub.

@juliekuehl: Let’s save those (really great) ideas for that blog post so we don’t lose them.

@Lisa: There are so many changes going on in WordPress this year

@juliekuehl: Info flows by in Slack so quickly we lose good stuff here!

@pbrocks: I like the idea of working in Github. Which means capturing ideas in Github, whether it be a Repository or an Issue in a repository.

@juliekuehl: Explain further @pbrocks.

@pbrocks: So, I agree that things get lost in Slack too easily. Github feels like the place to capture and document.

@Lisa: I like designing visually

@juliekuehl: @pbrocks did you mean for our welcome message and such?
It sure could be set up as an issue and we could all comment

@pbrocks: So, @Lisa I wouldn’t think that you would design there, but add to the list of ideas that we may have.

@Lisa: We could try opening thread each time a topic is raised
Verification
Maybe?

@tmichellemoore: How does the blog fit in the overall picture?

@juliekuehl: The Make blog will not be going away. We will continue to use that site for a proper handbook where all the questions that everyone is asking would be answered: what do we do, how can you contribute, what’s the process, etc. It’s such a messy time for you new folks. Sorry about that!

@Lisa: I will select a lesson plan draft and arrange design time. Julie should I wait until the verification process is ready.

@juliekuehl: To-do: record screencast for @tmichellemoore to document.

@juliekuehl: I know this team is a bit chaotic at the moment with all the changes, but I really appreciate folks stepping up to help. Sometimes even before we’re ready! But we’re making great progress and should be running smoothly again soon. Thanks for hanging in there everyone!

Automated Greeting in the #training Slack Channel

It is possible that we could set up a Slackbot to send a greeting when new people join the #training channel. (Hat tip to the #design team for this idea.) What would we want to see in that message?

Proposed content (add your ideas in the comments below!):

Welcome to the WordPress Training Team! We create downloadable lesson plans and related materials for instructors to use in live workshop environments. This all-volunteer team needs people with all kinds of skills!

Here are some handy links to get started in our community:

  • The Make WordPress Training blog is where you’ll find meeting agendas and summaries https://make.wordpress.org/training/
  • We communicate in the WordPress Slack #training channel. If you have questions, this is the best way to contact the team.
  • Check out our GitHub page to get an overview of what the Training Team is working on. https://wptrainingteam.github.io/
  • Take a look at our GitHub account where the actual work is done. You can find our in-progress lesson plans there too! https://github.com/wptrainingteam
  • We have more details in our handbook https://make.wordpress.org/training/handbook/
  • Finally, introduce yourself in the #training channel on Slack. It would be great to know where in the world you are located, what brings you to the training team, what your skills/background might be, and how you would like to contribute!

Great to have you onboard 🙂

(Note that the actual bot will need to be created by a WP Slack Admin.)