Publication, Edit, and Media Flow

Publishing a post with a captioned gallery is a litmus flow. This flow exercises the heart of what we’re making. Always be watching and improving publication flow. Continuously and recursively dogfood these flows.

Links: make/flow/#editor, components/editor, make/flow/#media, components/media, make/flow/#post-flow

Kibbling and Visual Oxygen

If communication is oxygen, then communicating with screenshots and visual records is Visual Oxygen. Accompanying tickets and chats with screenshots makes development more accessible and transparent.

Kibbling is the process of dogfooding a flow and publishing visual records and narratives of that flow. The make/flow blog is an example of a kibbling blog. Since we are publishing these “kibbles” with the software we are dogfooding, the act of kibbling further dogfoods the software. Kibbling encourages more dogfooding which encourages more kibbling and so on. Continuous recursive dogfooding and continuous visual recording is the flow patrol prescription for improving development culture, particularly on mobile.

Whenever UI changes, posting before and after screenshots should be a reflex. Every patch should be accompanied by screenshots. Any ticket lacking screenshots should be tagged needs-screenshots.

For feature plugins and significant patches, before and afters on multiple devices should be published to make/flow prior to commit. This is a commit requirement. While you’re testing, take some screenshots.

The ideal: Teams take screenshots as they dev and test (on their multiple devices). They post those screenshots as comparison visual records using the tool we’re all making, WordPress. Chock full of virtue are those two simple acts. Change awareness. Flow awareness. Flow comparison. Recursive dogfooding. Visual archiving. An engine for Empathy, Awareness and Visual Oxygen.


Links: glossary/kibbling, glossary/visual-oxygen, make/flow, make/flow/handbook


Moar checklists. Check out The Checklist Manifesto. Cognitive nets help flow.


Beta Testing Flow

We want beta testing to be easy. The beta testing handbook page describes how to get started with nightly builds. The 4.4 tracking page describes the teams working on 4.4 and how to help them. It also lists the feature plugins scheduled for 4.4. The component pages provide details on component teams and how to help them. All of these resources need to be expanded and kept up-to-date.

Feature plugins should be listed here and updated regularly, preferably nightly.

Finding maintainership for the beta tester plugin is important. It has bugs and lacks features. Watch the forum.

Tag tickets and posts related to beta testing flow with beta-testing-flow.

We have okay documentation for testing against nightly builds but pretty much no documentation for testing patches. The core handbook has little to say about patches.

Teams should publish calls-for-testing to make/core.


  • Public app beta testing flow.
  • Joining the Android beta testing program.
  • Patch testing with VVV on Mac OS.
  • Smooth switching from trunk nightlies to point release nightlies.
  • “We have an audience of auto-updating nightly build testers who are also running feature plugins. Don’t fatal their sites, whatever it takes.”
  • Add needs-screenshots to workflow keywords.
  • Android beta audience.
  • Handbook pages and beta testing flow.
  • Call for component page updates and component roadmaps.
  • s/nightly/continuous/ Nightly builds should be continuous.
  • Call to document grunt and patch testing flow.
  • #32613 is fixed. Switching a site between production and nightly is now a push button affair.
  • Maintaining core component pages
  • Added more detailed steps for installing the beta tester plugin to the beta testing page on 2015/06/26.
  • Opened #32551 – Superseded feature plugins should suggest deleting the plugin in the auto deactivation notice
  • Opened #32613 – Allow easy fallback to the latest stable release when beta testing with the beta tester plugin

Links: core/trac/#beta-testing-flow, meta/trac/#beta-testing-flow, make/flow/#beta-testing-flowmake/core/, make/core/handbook/beta/testing

Feature Plugins (todo: rework for feature projects)

Feature plugins greatly improve beta testing flow. Promote developing features as feature plugins and help feature plugins get through the process.


  • Keep feature plugins up to date and issue calls for testing.
  • Break the feature plugin checklist into separate merge criteria and merge checklist sections.
  • Create a template/starter feature plugin.
  • Feature plugins should turn themselves off gracefully once their feature is merged to core. They should not fatal error.
  • We need a method for disabling featured plugins once they’re merged.
  • We need to create a commit checklist for feature plugin merging. Here might be a good place to add it.

Links: plugins/beta, meta/handbook/feature-plugin-treatment, make/core/#feature-plugins+kickoff, make/core/#feature-plugins+merge+proposalmake/core/#feature-plugins+updatesmake/core/#feature-plugins+chatsmake/core/#feature-plugins

Mobile and Touch Usability

We are an open source project dedicated to the open web, regardless of device. That is part of our philosophy and soul. We will not force our users into walled gardens. Championing the open web on all devices is our duty.


iOS and the Open Mobile Web

iOS compromises the open mobile web. iOS Safari has many bugs that corrode the usability of WordPress. How can we make that better?


Carousels and touch media

Presenting a bare image page with no navigation in response to tapping an image is not good flow, particularly on touch devices. Modal/carousel treatment for images should be provided out of the box. When using Twitter, we run into this windmill often. So many WP sites have no modal/carousel treatment for images. Even ones with Jetpack have treatment only on galleries, not individual images. When visiting WP sites from Twitter and other apps, better image handling is expected. Image treatment is out of touch with touch flow.

  • #31467 is fixed in 4.4.
  • Images should default to not linking
  • Lack of modal image handling on make/core posts.
  • Carousel feature plugin suggestion.

Update Flow

  • Opened #33766 – Update notice links to an uncompelling codex page. Tagged it #update-flow.
  • Improve flow from the update notice; make pre-update screens, docs more compelling.

Related links: make/flow/#updates, make/flow/#upgrade-install, core/trac/#update-flow

Institutional Memory

If you’ve been around awhile, share what you remember. If a chat, ticket, or post needs some history, give it.


  • Image title attributes and displaying tooltips. and
  • The origin of pinking shears.
  • Why the updates icon is top-level in the toolbar.
  • The history of visit site in the admin header and WordPress > Network > Site hierarchy in the toolbar: and
  • Why visit site in the Home toolbar menu acts the way it does on touch devices. #desktop-bias

Roadmaps, Visions

We must communicate these better.

  • Express each new feature in a release in the context of a roadmap and a vision.
  • “Getting teams to update their component pages with what they’re up to for 4.4 would assist beta testing flow and encourage communicating roadmaps and visions.”
  • Releases needs a focus and tagline.

Links: make/core/#roadmaps, components

PHP Version Requirements


  • #meta802 Requirements page should recommend supported and secure PHP and MySQL versions
  • These two comments should become core handbook pages.

Note common usability problems such as #boxed-input-scrolling, #rogue-cursor, #keyboard-flyup, and #scroll-bleed and add them to the glossary. Use these tags on tickets and make/flow posts during triage. Help develop the language of flow.


  • Consider adding go-back-flow, sideways, image-rotation, tap-bleed, elastic-bounceback, new-tab-window (instead of open-in-in-new-window), flow-home, no-title, switch-site, menu-dismiss, publish-context, post-flow, needs-responsive, needs-*, parity, feature-plugins
  • Added Visual Oxygen. Need to work this more into the kibbling documentation. Kibbling is an engine for visual oxygen.