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:
2. Discussion on verification workflow in GitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/
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 A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org
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 A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party 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 The Training Team uses GitHub for working copies of lesson plans. You can find them at https://github.com/wptrainingteam. 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 Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. 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!
@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 Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. 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.
@tmichellemoore: It would be nice if the integration could place a notification in this slack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. 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
@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!