Selected work

Dev-rel publishing on WordPress VIP

BlackBerry's developer-relations blog on WordPress VIP — code samples, SDK release notes, API guidance. Theme work through the 2011 and 2013 rebuilds.

The BlackBerry Developer Blog homepage as it appeared June 2016, showing the green developer colour treatment and post grid with technical headlines.
Client
BlackBerry Waterloo, ON
Platform
WordPress VIP
Year
2011–2014
Status
Archived

BlackBerry®’s Developer Blog was the dev-rel surface in the WordPress® VIP estate — code samples, SDK release notes, API guidance, conference recaps for an audience writing software for BlackBerry devices. devblog.blackberry.com was the most peer-credible of the four properties, the one whose readers were checking the bylines for individual dev-rel team members and following the comment threads for technical clarification.

Full-page scroll of the BlackBerry Developer Blog homepage from June 2016 — dev-rel category navigation and SDK release content visible.
Full page archive: web.archive.org/web/20160602121438/devblog.blackberry.com — June 2016.

Code samples as a first-class template concern

Dev-rel content has different theme requirements than marketing content. Code blocks have to render with correct syntax highlighting across languages. Snippets have to be copyable in one click without the surrounding chrome going along with the copy. Indentation has to survive the editor round-trip from the dev-rel author’s IDE through the WordPress block editor to the rendered article page. None of those concerns appears on a consumer-marketing blog. All of them appear on every page of devblog. The theme decisions had to treat code escaping, syntax-highlighted blocks, downloadable SDK assets, and inline copy buttons as first-class content types — not as decorations bolted onto a template designed for prose.

SDK release notes and the version-tagged archive problem

Developer-blog content has the longest useful lifespan of any blog content. An SDK release note from 2013 is still being referenced in 2018 by a developer trying to understand why a deprecated API behaves the way it does. That changes how the archive has to work. Version-tagged posts need stable URLs. Category and tag taxonomy has to differentiate “current best practice” from “historical context” from “deprecated, do not use.” A reader landing on a four-year-old post needs immediate context about whether the guidance still applies. The theme had to make that context legible in the article header rather than forcing the reader to check the publication date and do the arithmetic themselves.

vip/rimdevblog was the slug the dev-rel team typed into their git remote, and renaming would have broken three years of internal documentation that referenced the deploy by slug. The October 2013 redesign folded the developer blog onto the shared vip/blackberry-blogs codebase but kept the property’s distinct identity through colour classes (the dev green treatment), logo-header-dev.gif, and favicon-dev.ico. The underlying theme was now one of four sibling brands inside a single codebase.

Where dev-rel publishing breaks WordPress defaults

Building dev-rel affordances inside the WordPress VIP environment was easier in some ways and harder in others than building them on a self-hosted stack. Easier, because the code-review gate kept the dev-rel team’s velocity honest — no shipping a theme update that broke the syntax highlighter on three thousand legacy posts. Harder, because some of the plugins a self-hosted developer blog would have reached for were on the VIP disallow list, which forced theme-level solutions for things a plugin could have handled in five minutes on a self-hosted install. The trade was the right one for an estate this size; it would have been the wrong one for a single-person dev-rel blog with three posts a year. The architecture honours the scale.

  • The work: Dev-rel child theme; code-block and syntax-highlighting templates; version-tagged archive taxonomy; downloadable-asset templates
  • Platform: WordPress VIP; 2011 migration off self-hosted (June 2011 first capture); 2013 redesign onto shared codebase
  • Client: BlackBerry Limited (developer relations), Waterloo, Ontario
  • Period: 2011-2014; property ran until March 30, 2019

Sibling properties: the Inside BlackBerry hub and the Help Blog, with which the developer blog shared an unusual amount of technical-reader audience overlap. devblog.blackberry.com now 301-redirects to BlackBerry’s current developer-solution blog inside the corporate site, rebuilt off WordPress.

The dev-rel-blog lesson that travels: technical-content templates have to treat code, version, and longevity as first-class concerns, because the audience reading them in five years’ time deserves to know whether the guidance still applies. The theme that gets that right is the one that earns the dev-rel team’s trust.

Christopher Ross

Your consultant

Christopher Ross

I lead the work personally, from discovery and architecture through delivery and handoff.

  • Twenty-two years delivering training and nineteen years building with WordPress.
  • Direct delivery for media, education, and federal government programs.

Sectors covered: Media · Education · Government