Handbook Redesign

The Handbooks are slowly being updated to the o2 theme (Breathe). With this upgrade, I’ve been thinking about how we present our documentation, reference materials, etc. While Breathe was definitely refreshing, there’s still some experience issues I need to work through.


Right now, the amount of floating menus on the page is too many. When navigating to a Handbook page there’s a floating menu on the left side, and possibly another floating menu on the right side for in-page navigation. This compresses the initial intro of the document a user might be reading causing some confusion with its odd flow of characters.

Current Handbook



I believe we could alleviate some of this by anchoring the left side menu a bit better and structuring these pages to appear more like a true documentation portal. I made a few changes in Inspector within the browser and came up with something like this (b/c of this there’s no mobile version yet):



Some PROS and CONS are mentioned in a conversation here: https://meta.trac.wordpress.org/ticket/2389


Please leave some feedback here in the comments or on the actual ticket. Everything is helpful. I’m personally struggling with the floating right-side menu. There’s been some good ideas for solutions, what’s yours? If you have a few minutes to take a brief survey regarding the Handbook usage, please do! Handbook Usage Survey


#design, #make

Howdy everyone I think it’s time for Marketing…

Howdy everyone! I think it’s time for Marketing to have its own Make section on .org – as I posted a few months ago on this p2 with lots of ideas moving forward, we’ve had several Marketing 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/. groups (3 at 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, and one at WCUS a week ago), the Security whitepaper was released mainly for marketing reasons (and now has been translated into Japanese, Romanian, Indonesian, and Spanish, with several other languages in progress), and the WCUS Contributor Day group actually shipped a WP Flyer/Sales Sheet we’re proud to share with the WP world and get people using it and translating it.

There’s a lot of work to do, and there are a lot of people who are interested in contributing. We need some space!

Just a note of clarification: the marketing team would focus on materials which help people/individuals sell/market WordPress the software – i.e., the security whitepaper and other whitepapers, the sales sheet, the 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. presentation, etc.

I am more than happy to help moderate / staff / populate the p2, and set up monthly or biweekly meetings while we staff up.

Update: the new Marketing p2 is here: https://make.wordpress.org/marketing/ We’ll start populating it and getting it moving now!

#make, #marketing, #p2s

@otto42 Can you get rid of the make…

@otto42: Can you get rid of the 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//events blog? We pushed it into /community a long time ago, but the site is still there, and people still wind up there and leave comments that no one responds to.

#make, #site-deletion

The accessibility team needs a plugin for their…

The accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) team needs a 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 for their site that will allow them to create tables for displaying tabular data/content in their accessibility reports (pages). I know TMCE has a table builder that we could add, but what I’m not sure about is if it creates accessible tables.

1. Getting tables on there at all: better with a plugin that’s already out there, or better to write a one-off that just adds that one thing?

2. Once the options are identified something in place, @accessiblejoe can take a look at the table output to see if it’s accessible of if we need to write an add-on to make it that way.

#accessibilty, #make, #tinymce

A while back on September 11 @andreamiddleton tried…

A while back on September 11, @andreamiddleton tried to import the /events blog into the /community blog since we were merging teams. She hit a bug/error/some kind of blocker in the import and reported it. @nacin and @otto42 said they’d look into the weird encoding issues. It wasn’t a priority, sure, but in the meantime we’re double-posting stuff and we still haven’t truly merged the groups. Could someone see if this can be figured out?

#community, #events, #import, #make

@otto42 @iandunn posted a plugin on trac for…

@otto42: @iandunn posted a plugin on trac for the /community team site 5 weeks ago. Could that get added, or if it’s not ready could you tell him what he needs to change? It’s a bottleneck for some stuff we want to do on our team site to make it easier for groups working on separate projects. Thanks!

#community, #make, #plugin

Today I imported all make wordpress org events…

Today I imported all 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//events posts to make.wordpress.org/community. This resulted in three unexpected results.

1.) I chose to import users from /events, but those users don’t seem to have been imported. (I added heatheracton and adavis3105 as a test for the second issue.)

2.) Comments made by authors on /events are now showing my GravatarGravatar Is an acronym for Globally Recognized Avatar. It is the avatar system managed by WordPress.com, and used within the WordPress software. https://gravatar.com/. and, when you click on their names, connect to my wporg profile. For example, Heather Acton’s comment here. A close up: http://cl.ly/image/2d05343x101V

3.) There seems to be a character encoding issue on imported content: http://cl.ly/image/2q2I1D1d3q0t

Help me, metaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. team, you’re my only hope. 🙂

#import, #make

Time Shortcode for Make P2s

A couple of weeks ago, Siobhan pointed out to me the difficulties in talking about times for IRC meetups on the various P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. blogs. She suggested a shortcodeShortcode A shortcode is a placeholder used within a WordPress post, page, or widget to insert a form or function generated by a plugin in a specific location on your site. to make it easier to specify times.

So I wrote a first draft of a shortcode to make this a bit easier. It’s not perfect, but I figured to go ahead and tell people now, so that you all could go ahead and start banging on it and telling me what the problems are.

Usage: [time] some-time-format-here [/time]

By “some-time-format-here”, I’m being a bit generous. You can use pretty much any time format you can think of and it will attempt to figure it out. With extra emphasis on “attempt”.

Stuff like this all works:

  • March 30, 2013 1pm UTC
  • April 4th at 1pm
  • April 4th around 1pm
  • April 4th 2012 1pm
  • next monday 1pm CDT
  • 1pm UTC

Now, a few important points:

  • If you don’t specify a timezone, you’ll probably get UTC. This is just for now, until I work out a better way.
  • If it can’t figure it out, you’ll notice no change in your text. Hopefully.
  • If it gets really confused, it’ll probably say January 1st, 1970. 🙂
  • “Absolute” times are more likely to work than “relative” ones. Give a date, and year, and time, and timezone, and you’ll probably be good.
  • Timezones matter in terms of daylight savings. GMT is not the same as BST (British Summer Time).

So, what’s the point? Well, if it can figure out what time you meant, then it’ll encode that and a bit of 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/. will then localize that time to the viewer of the make P2 in question on load, assuming their browser knows what timezone they’re in.

So when I post “April 3rd, 2013 6:30pm CDT” (my current time) in the time shortcode, it’ll show this instead: April 3rd, 2013 6:30pm CDT. What you see there depends on where you live.

Hopefully this will make it somewhat easier to schedule IRC meetups and such. Let me know when (not if) you break it. Happy to iterate.

#make, #plugin

Make and Learn networks both running 3.6 alpha…

Make and Learn networks: both running 3.6 alpha, but show ‘update network’ alert in all admin screens. Any way to turn that off?


AddedInvited George to this blog with posting privs…

AddedInvited George to this blog with posting privs so he can post stuff including images around the sites that he’s working on here with us.

Otto: The make network is set up so that adding a user can’t be done without the confirmation email. Can we reverse that, or at least turn on the option? A lot of times the emails seem to not get there.

#authors, #make