Tag Archives: chat recap

Eric Amundson 7:32 pm on December 5, 2013
Tags: chat recap   

Docs Meetup Roundup – Dec 5, 2013

Howdy folks,

This week, like last week, was relatively quiet in the chat, due largely to the US Thanksgiving holiday.

Here’s a recap of todays chat:

1. Docs Sprint

There’s another Docs Sprint this Saturday, Dec 7th @ 10am Pacific and you can join us on IRC at #wordpress-sfd.

2. Admin Screen Updates

With the scheduled release of WordPress 3.8, which includes a makeover of the WordPress Admin, we need to work on updating the Administration Screen pages in the Codex.

@kimparsell will post a list of pages that need to be reviewed and updated on make.wordpress.org/docs.  Please help by grabbing one (or more) pages and updating.

3. WordPress 3.8 Codex Page

@DrewAPicture could use some help updating the Codex page for WordPress 3.8.

Drew usually combs through all of the change sets to find what’s new, changed, etcetera and it’s quite time-consuming.

If you can help, please leave a comment on this post and @DrewAPicture will help provide direction.

4. DevHub

Still making progress on developer.wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/.  There are some tickets filed and some things attached to them.

5. Make/Docs SidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.

@DrewAPicture also updated and consolidated the Weekly IRC Chats widgetWidget A WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. in the sidebar of make.wordpress.org/docs

That’s it for this week. Have a great weekend and hope to see you at the Docs Sprint on Saturday.

#chat-recap

Eric Amundson 5:51 pm on November 26, 2013
Tags: chat recap   

Docs Meetup Roundup – Nov 21, 2013

1. Docs Issue Tracker Mockups

@sams has the issue tracker mockups and is working on finding a developer.

2. Docs Sprints

Had a few new contributors to our latest Docs Sprint and are making steady progress on both Theme and Developer Handbooks.

Next Docs Sprint is Saturday, Dec 7th at 10am PST – hope to see you there.

3. DevHub

@rarst and @krogsgard are both working on the theme development and are making progress.

4. Inline Docs

Are still making progress and passed the 100 file completed mark last Tuesday.

#chat-recap

Eric Amundson 6:32 pm on November 14, 2013
Tags: chat recap   

Docs Meetup Roundup – Nov 14, 2013

1. Docs Issue Tracker Mockups

@sams sent a wrap-up of Docs Issue Tracker feedback to @karmatosed and she’s going to have something by early next week. When that’s ready, he’ll get a developer to work on it and we’ll have an updated timeline.

Thanks to all who gave feedback on the mockups!

2. Docs Sprints

There’s another Docs Sprint this Saturday November 16th, for those who can join in person or via IRC at #wordpress-sfd.

3. Theme Dev HB Opening

@iandstewart gave us permission to use any of the content from the Theme Shaper tutorial in the Theme Developer Handbook.  Thanks Ian!

@sewmyheadon will work on incorporating whatever makes sense into the Handbook.

4. Theme & PluginPlugin 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 HB Spreadsheets Revamped

Authors vs. Contributors

In the Handbook reporting spreadsheets, we changed Owner/Author columns to read Contributors because we found that several of the original owners/authors haven’t worked on the docs in months and we don’t want to discourage other folks from contributing.

So, we’re asking contributors to list their name in the Contributors column for future reference.

Noting Individual Document Progress

If you’re working on docs in the Theme or Plugin Dev Handbooks, please note the percentage complete (based on your best guess) in the % column.  This gives us a more realistic overview of each document’s progress.

@siobhan will also add @sewmyheadon to receive emails when updates are made to the Theme Dev Handbook to better monitor progress.

Retiring the Handbook Reporting Threads

We’ve ditched the old Handbook reporting threads on make.wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org//docs because they weren’t being updated.

Instead, please note progress, questions, problems, etcetera in the corresponding Handbook Spreadsheets instead, or simply post comments in the Handbook page.

5. Working Online

In order to make sure we’re all “on the same page” (pardon the pun), we’re asking folks to post all Handbook content directly to the Handbook, rather than writing offline.  This helps contributors and editors see actual progress, so they can dive in and help without worrying about stepping on toes or duplicating work.

To this end, we’ll be granting editor access to Handbook contributors so they can work online.

If you are working on any Handbook content that is not yet posted to the Handbook, or if you need editor access, please contact @sewmyheadon, @siobhan, or @hanni and we’ll help get it posted right away.

6. Team RepTeam Rep A Team Rep is a person who represents the Make WordPress team to the rest of the project, make sure issues are raised and addressed as needed, and coordinates cross-team efforts. Meetings

@siobhan inquired about the status of the Team Rep Meetings that are organized by @jenmylo. While I heard talk of this a few months ago, there haven’t, to my knowledge, been any team meetings.

7. DevHub

@krogsgard has promised us a theme by Sunday or Monday. Getting the DevHub theme finished should spur some actions and more progress.

Thanks folks and have a great weekend!

#chat-recap

Eric Amundson 7:18 pm on November 12, 2013
Tags: chat recap   

Docs Meetup Roundup – Nov 7, 2013

Sorry for the late post, folks. Here’s a rundown of what happened in last Thursday’s Docs Chat:

1. Docs chat time updated

Since Daylight Savings is over, we’re now meeting weekly at 17:00 UTC, which is still 9am Pacific.

2. Docs Issue Tracker Mockups

@sams posted mockups of the Docs Issue Tracker and would like more feedback.

3. Docs Sprints

Last meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. on Nov 2 was productive and we have another coming up Saturday November 16th, for those who can join in person or via IRC.

4. Theme Dev HB Opening

@sams and @sewmyheadon discussed creating a new intro for the Theme Dev Handbook that gets the reader right into a theme from the start. A very basic theme that we can use to illustrate the principles of theme dev. This will give the reader a gentler intro into each main aspect of theme development, and allow us to setup the rest of the more in-depth content.

Right now, the Handbook contains a lot of useful info, but needs to be tailored to getting new developers up-to-speed quickly without overwhelming them with jargon or specifics.

@sewmyheadon will work on this intro for now.

5. Theme & PluginPlugin 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 HB Spreadsheets Revamped – need %

@sams revamped the spreadsheets we’re using to catalog the Handbook development progress. There’s now a % column, which we’re using to put our best guess of percentage completion for each page. So, if you’re working on either handbook, please enter in numbers for the pages that you touch, so we can get a better overall estimate of Handbook progress.

6. Inline Docs

Inline Docs posted a status update post, which prompted some new patch contributions.

As of the meeting, the stats are:

  • Total: 185 files,
  • Completed: 92 files (49.72%);
  • In progress: 32 files;
  • Available to claim: 61 files.

7. DevHub

Is in active development now.

#chat-recap

Eric Amundson 5:20 pm on November 2, 2013
Tags: chat recap   

Docs Meetup Roundup – Oct 31, 2013

The Docs meeting this week was relatively short, so not a lot to report aside from:

1. Docs Sprint

There’s one happening now, Saturday Nov 2 and you’re welcome to join if you have time: http://www.meetup.com/SeattleWordPressMeetup/events/143053012/

We’re working on Theme and PluginPlugin 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 Developer Handbooks.

2. Inline Docs

@kimparsell reports steady progress at 92 files completed, 185 files total (49.72%). One more file and they’ve hit 50%.

3. WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Sofia Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.

@nofearinc organized Contributor Day at WordCamp Sofia, which brought in four new contributors: @aralbald, @ninio, @admiralthrawn, and @l10n.

These folks documented 11 of the 15 files reserved for their contributor day. A huge thank you to @nofearinc and @koveshenin for helping these contributors get their first patches committed to coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.. 🙂

4. DevHub

@siobhan mentioned @saracannon has delivered designs to @krogsgard and @otto42 is working on stuff too.

Thanks folks and have a great weekend!

#chat-recap

Eric Amundson 10:59 pm on October 25, 2013
Tags: chat recap   

Docs Meetup Roundup – Oct 24, 2013

First, thanks to @kimparsell for leading last week’s chat and posting in my stead while I was out of town.

Here’s what happened this week in our chat. If you’re interested, you can read the full chat logs.

1. DevHub

@saracannon and @sams posted new DevHub design mockups and would like your feedback at: https://make.wordpress.org/docs/2013/10/21/feedback-on-devhub-designs/

2. Epub Docs

As @kimparsell noted last week, there was an offer to publish the WP Docs in epub format, but unfortunately, it required proprietary code, which is a no-go on wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/, so we won’t be pursuing this at this time.

3. Inline Docs

@kimparsell is working to finalize the standards change re: the parser and they’re making steady progress; currently at 73 files completed, 185 files total (39.45%)

4. WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Sofia Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.

@kimparsell and @sewmyheadon have posted here on make.wordpress.org/docs with some guidance for the contributors at WordCamp Sofia for Inline Docs and Handbooks.

5. WordPress 3.7

@DrewAPicture and @ipstenu whipped the Codex WordPress 3.7 page in the Codex into shape. Great job!

6. Docs Sprints

Had a Docs Sprint last weekend and had four contributors working on the Handbooks. Thanks to all who showed up!

We’re still holding two Docs Sprints per month that anyone can join via IRC or in-person if you’re in Seattle. Would love to get some more participation so feel free to join us in IRC on Nov. 2 at 10am Pacific (5pm UTC).

#chat-recap

Kim Parsell 12:28 pm on October 18, 2013
Tags: chat recap   

Docs Chat: 17 October 2013

@sewmyheadon is away at a conference, and asked me to lead the chat today in his absence.

Thank you to everyone who came. For anyone unable to attend, you can read the logs here.

The following is a summary of the topics discussed.

1. Internationalizing Codex/Docs Code Examples

Prompted by a discussion on Twitter, @siobhan asked on Make/Polyglots whether all code examples in the Codex and other official WordPress documentation should be internationalized. There was already quite a bit discussion in the post’s comments prior to the meeting.

@nacin said the two primary issues with internationalizing code examples are: (1) increasing the barrier to entry for new developers; and (2) use of the internationalization function doesn’t actually internationalize the code. (see his full comment here)

@xibe proposed that we provide a link to the i18n Codex page at the bottom of every code example with translatable strings saying, more or less, “Code is simplified for readability reasons. Production code should have all the strings internationalized.”.

That seems to be the best option for now. We’ll be putting out a call for someone to review the code examples, and add text to ones with translatable strings, say that they are examples, and should be internationalized when used in production code, plugins, or themes.

2. EPub Docs

@siobhan had an email from someone who has offered to publish the WordPress docs in epub format. Mike (mac2net) joined us in IRC to discuss the offer, and how it would work. Unfortunately, it currently involves the software running on an external server. @sams and @siobhan both stated that we can’t (a) use an external service, or (b) use non-open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. code. @sams and mac2net will be continuing the discussion over email to see if the obstacles can be worked out so that everything runs on the wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ servers, and report back on the progress during next week’s chat.

3. Inline Docs

Discussed at this week’s devhub meeting are changes that need to be made in the PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. http://php.net/manual/en/intro-whatis.php. Docs Standard to incorporate markdown into the doc blocks to fix formatting issues when they are run through the parser. I’ll talk with @rarst to verify the requirements, then we’ll get the standard updated. We noted at yesterday’s Inline Docs chat that we’ll also review the already-submitted patches for any changes that may need to be made. Current status: 72 files completed, 184 files total (39.1%).

4. WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Sofia Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.

@nofearinc asked on Twitter today if there’s anything in particular that they can help with during the WordCamp Sofia Contributor Day, scheduled for 10/27/2013. I’ll work on a list of Inline Docs tasks. @hanni and @sewmyheadon will put together a list of tasks for the pluginPlugin 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/theme developer handbooks.

5. WordPress 3.7

@siobhan asked about Codex/Docs tasks that need to be completed before 3.7 is released. @drewapicture has already volunteered to write the 3.7 page in the Codex. A new page needs to be written about the automatic updates, with a section for users (explaining how they work) and a section for developers (under the hood goodies). Depending on the length/complexity, it may be best to split it out into two pages.

6. devhub

@siobhan said that all is going well with the devhub project. @toscho and @krogsgard have joined the team. @toscho and @rarst are doing the code reference development. @krogsgard will be building the new theme for developer.wordpress.org.

7. Handbooks

@hanni reported that she gained two new contributors for the plugin developer handbook at WordCamp Europe. Progress was made on the handbook during their contributor day, and she is currently reviewing the contributions.

And that wraps up this week’s chat summary. @sewmyheadon will be back for next week’s chat on Thursday at 16:00 UTC.

#chat-recap

Eric Amundson 11:15 pm on October 14, 2013
Tags: chat recap   

Docs Meetup Roundup – Oct 10, 2013

1. DevHub

@rarst and @toscho are both now working on developer.wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/.

2. Handbooks

WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. EU worked on PluginPlugin 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 Developer Handbook.

Virtual Docs MeetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. worked primarily on Theme Developer Handbook.

3. Virtual Docs Sprint

The first virtual Docs Sprint went well and we had 5 or 6 contributors from three different countries. 🙂

Got feedback from one contributor that virtual meetups can be boring unless you’re already working on something; so we’ll likely even meet in-person (in the Seattle area) on virtual docs meetup days. Would love to see other contributors organize their own local in-person Docs Sprints.

We have another Docs Sprint this Sunday, October 20th so join us on IRC or in-person, if you’re in the Seattle area.

4. Theme School Curriculum

@courtneydawn and @sewmyheadon met on IRC during the Meetup and looked at both the Theme Dev Handbook and Theme School Curriculum and see significant overlap, so we’re going to review both efforts and see how we can leverage good content in both places without duplicating work.

5. Inline Docs

@kimparsell reports that they’re still plugging away and got new contributors from both WCTO and WCEU (yea!).  Thanks contributors!

Current status: 67 of 184 files complete (~36%).

Have a great week!

#chat-recap

Eric Amundson 4:31 pm on October 4, 2013
Tags: chat recap   

Docs Meetup Roundup – Oct 3, 2013

Howdy Folks,

Pretty light week this week, but here are a few status updates from our chat yesterday:

1. Virtual Docs MeetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area.

We’re having a Virtual Docs Sprint this Saturday at 10am PDT.  Join us if you can on IRC in #wordpress-sfd.

Here’s the Docs Sprint schedule through December.

Also, Amy Hendrix (@sabreuse), posted about our Docs Meetups on the Community blog.  Thanks Amy!

2. Handbooks

No new progress, but we’ll be working on these again tomorrow at the Virtual Docs Sprint.

3. Theme School Curriculum

Last week, we mentioned the Theme School Curriculum and Courtney (@courtneydawn) and I will connect tomorrow during the Docs Sprint to see how we may help each other.

4. Inline Docs

Work is continuing on the hook docs: 46 files completed, 184 files total, and the biggest files are yet to be done.

—

Have a great weekend and hope to see you at the Sprint tomorrow!

#chat-recap

Eric Amundson 10:22 pm on September 29, 2013
Tags: chat recap   

Docs Meetup Roundup – Sept 26, 2013

1. DevHub Landing Page

On developer.wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ – we’ve got some landing page designs from @saracannon so things are going in the right direction.  Here’s the writeup from last meeting.

2. Theme School Curriculum

Theme School Curriculum is happening on make/community. I’ll get in touch with Courtney to see how we might help each other.

3. Theme & PluginPlugin 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 Developer Handbooks

We’re making slow progress on the Handbooks. Two monthly Docs Meetups are working on Handbooks to drive progress.

Was some discussion about if/how to add Theme Hook Alliance to the Theme Dev Handbook and we decided that we’ll add it as a resource link rather than featuring a page.

4. Virtual Docs Dates

We’ve got a virtual docs meetupMeetup All local/regional gatherings that are officially a part of the WordPress world but are not WordCamps are organized through https://www.meetup.com/. A meetup is typically a chance for local WordPress users to get together and share new ideas and seek help from one another. Searching for ‘WordPress’ on meetup.com will help you find options in your area. scheduled each month through the end of the year, currently posted on Seattle WordPress Meetup and soon to be posted here too.

There’s also an in-person Docs Meetup two weeks later and we’re always on IRC, so feel free to join in there too. The more participation, the faster we’ve got a terrific resource in the Handbooks.

5. Codex Spam

It’s still a problem, so please keep your eyes open and follow the instructions in @kimparsell’s Codex Spam post if you find spam.

6. Inline Docs

@kimparsell reported they’re making steady progress had a productive weekly meetup where they reviewed past week’s progress, re-evaluated the new workflow and made a few adjustments.

7. Admin Help

@jazzs3quence reported that the Admin Help volunteers are looking for mockups for new ideas, so if anyone has ideas/suggestions about how help can be handled, make a mockup and post it.

#chat-recap