WCSF 2014 Docs Contrib Day Notes

Purpose to see how we are doing on Docs and look towards the future

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 handbook

  • Almost complete. One page left to write
  • Siobhan is holding back launch with the intro 😉
  • 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/ will be updated to unveil the plugin hb tomorrow!
  • How can we get feedback from the users on handbook pages?
  • Add list of pages from the codex that can be redirected or need content migrated into the spreadsheet

Theme handbook

  • At 67% completion
  • Future focus can be put completely on theme hb instead of splitting with plugins

Contributor days

  • Difficult to retain contributors
  • Takes a while to get them up to speed on how to contribute
  • Are still useful as contributors that do return contribute significantly

Developer.wordpress.org

  • Landing page will show the new theme
  • Theme hb link should be whited out and say coming soon
  • Need examples contributed to the code reference
  • Need a way to group together items in the functions reference. Possibly a tag that can be added. Scott (coffee2code) is looking into options
  • The JSONJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. docs need to be pulled in. Currently exist as markdown on GithubGitHub 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/
  • Need a banner on the handbooks that lets users know all content is volunteer contributed and they can get involved

Future

  • Go through codex and find pages that can be relevant to the plugin handbook
  • Siobhan will provide list of high traffic codex pages that need to be checked for content and redirected to plugin handbook
  • Need list of content that is duplicated between both plugin and theme handbook (E.G javascriptJavaScript JavaScript or JS is an object-oriented computer programming language commonly used to create interactive effects within web browsers. WordPress makes extensive use of JS for a better user experience. While PHP is executed on the server, JS executes within a user’s browser. https://www.javascript.com/.)
  • Where should content live that does not exactly live in either handbook? (E.G list of javascript libraries built into WordPress)
  • Need a SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. bot that will send messages to #docs when user wants to ask a question???
  • How do we easily let in new users to edit handbooks? This needs more discussion. Prefer to contact a human to get access. Preferably one of the editors
  • Will be implementing an issue tracking system that will contain tickets for things that need updated/added

Make.wordpress.org/docs

  • Instead of weekly meetings we should use the blog to post questions, get feedback, etc
  • Switch to monthly all docs team chats

#handbooks, #wcsf2014

WCSF Final Planning

If you are not attending WCSF this year, you can ignore this post. If you are coming and planning to participate as part of the docs team, please click through and read it all. 🙂

Continue reading

#wcsf, #wcsf2014

WCSF Contributor Day

We’ve made plans to work on completing both the developer handbooks during our two day team 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. following WCSF.

I’d like to use this thread to discuss ideas on what Docs tasks we can have contributors work on during 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/. on Sunday.

This is a good opportunity to have contributors work on non-handbook tasks that also need to be completed.

A couple possibilities are:

  • Code Reference MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies.: migration of content from the Codex code references to the new code reference, including reviewing content, adding examples, and setting up redirects from the Codex.
  • Codex cleanup: review of Codex content – editing, truncating, deleting pages that are out of date.

If you have other suggestions, please add them in the comments. Also indicate whether you’ll be available to work with new contributors on Sunday.

#contributor-day, #wcsf2014

Docs at WCSF

As I’m sure you all know, there will be a summit + contributor working days following 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. San Francisco this year. We should decide in advance what we are going to do. We have two working days (Tuesday & Wednesday) during which to tackle docs stuff.

My own feeling is that by Tuesday we’ll be pretty much talked out so I don’t think spending the two days in discussions about docs would be that productive. Instead, we should come up with a project in advance and spend the two days actively working on it. I think it would be best if we all worked together as a team on one single project, rather than working on different things.

Let’s use this thread to discuss ideas. Here are some possibilities:

  • Complete the handbooks – complete all of the content in the handbooks, review content, and make sure that V1 is 100% shipped.
  • Code Reference MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. – migration of content from the code references in the Codex to the code reference, including reviewing content, adding examples, and setting up redirects from the Codex
  • Support Hub – start making plans for a new support hub. Sketch out new content. Write content. Get someone to work on designs.
  • Codex cleanup – review of Codex content – editing, truncating, deleting pages that are out of date.

Please make your own suggestions – the sky’s the limit, though remember that we have two days and it’s off the back of WCSF and the summit, so be realistic 🙂

We should come to a consensus in the next few weeks so we can plan how to best use our time over the two days.

Also, can you please leave a note to say if you’re attending WCSF so we know how many team members we’ll have there. And can you note if you’re involved with any other teams and, if you are, how much of your time you think will be dedicated to that team.

#docs-team-meetup, #summit, #wcsf2014

WCSF Tickets, Meetup

Anyone planning to attend WCSF this year from the docs team, please read the post at https://make.wordpress.org/updates/2014/09/08/wcsf-tickets-and-stuff/ for information about WCSF ticket sales and the contributor days following the main conference. Please click the link and read that post *before* asking questions on this thread. 🙂

If you are planning to attend the docs team 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. but I have not been in touch with you regarding hotels/travel dates, please pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” me in IRC (jenmylo) or shoot me an email (same username @wordpress.org) so I can include you in the planning.

Thanks!

#docs-team-meetup, #wcsf2014

Team Meetup at WCSF (More)

Hi again! We’re working on making sure we have enough room blocks to make sure all the contributors who are coming in October can get a decent rate (or have a room provided by us if needed). Some of you replied to my post from last week and filled in the survey so I’d know you were planning to come, but some haven’t. Additionally, some people did the survey and marked themselves as team members of teams they’re not actually involved with, so I need your help! 🙂

I just want to make sure we count everyone so we can try to put you at the same hotel to make the 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. part easier (though I know most people on this team are also heavily involved in other teams, so we’ll figure that once we have a solid tally of who’s planning to come at all).

If you didn’t read the post before, the plan for the event is:
Sat/Sun — WCSF conference
Monday — community summit
Tues/Wed — team meetups (team being together to talk issues, make plans, work together, etc)

The people who identified themselves as active members of the docs team in the survey are: @jerrysarcastic, @drewapicture, @trishasalas, @topher1kenobe, @hanni, @kpdesign, @nicolealleyinteractivecom, @davidjlaietta, @jazzs3quence, @sewmyheadon, @siobhan, @otto42 (all authors on this team blog), as well as:
Cousett Hoover, Benjamin Hansen, John Blackbourn, Ed Caissie, and Russell Fair.

Is this an accurate list? @kpdesign, can you let me know if these folks are all active with the docs team, and also tell me if there’s anyone missing that you think should be there from the team? Comment here, email me, hit me in irc, whatever’s easiest.

Any docs folks not listed above who are active on the team and want to come to the team meetup should fill out the survey so I can have you on the list as we start deciding which hotels to put each team in. We’ll be spread out among 4 or 5 hotels, so I want to be sure we can keep the teams together.

And just a reminder that we have a travel assistance program this year to help contributors who don’t work for a wp-based company and can’t cover travel costs on their own. Apply for travel assistance by June 30 Applications for travel assistance are now closed. If you need help, contact @jenmylo.

Thanks!

#meetup, #wcsf2014

WCSF Details and a Request

Heads up, docs team! We’re getting ready to publish details about the plans for WordCamp San Francisco this October (which includes a mini team meetup), so if you’re thinking of attending, please read the post at https://make.wordpress.org/updates/2014/06/12/wordcamp-san-francisco-travel-contributor-days/ and take the short survey linked at the end of it so I’ll know how many team members to plan for (don’t worry, this isn’t a commitment or anything, I just need to get some rough numbers for budgeting purposes). Thanks!

#meetup, #wcsf, #wcsf2014