Feb 142013

We’ve had a few updates to the Kuma platform that powers MDN lately, and now there have been enough interesting changes that I thought I’d share them with you!

  • A bug causing translated articles to sometimes get “en” injected into their slug has been fixed. This caused a number of pages to wind up in the wrong places. Pages that had already been affected have mostly been fixed. There’s an explanation of what localization teams might have to fix here.
  • We’ve fixed a bug that was preventing live samples and embedded SVG images from working correctly.
  • Fixed a bug that caused the editor toolbar to not be fully visible on-screen when you put the editor into full-screen mode.
  • When adding an attachment to a page, the “description” and “comment” fields are now optional.
  • A link to the wiki dashboards has been added to the root docs landing page.
  • The MDN home page has been cleaned up to be significantly less messy. We’ve removed a lot of promo blocks that we were never all that happy with, so the page is significantly easier to use. There’s a more substantial redesign under way, but it’ll be a while before that lands.
  • A bug causing layout problems when you zoomed in on the home page has been fixed.
  • CORS has been configured to allow sites to pull content from MDN using the Kuma API.
  • For security reasons, file attachments are now served from the same alternate domain as live samples.
  • Demo Derby uploads whose Zip files’ names have non-ASCII characters in them are now accepted.
  • The text of the “Revert” link in the page history view has been updated to clarify what it does. This feature is still incorrectly only available to users with special privileges; we have an open bug to correct this.

There’s a lot of good stuff in here! These aren’t the only changes, but they’re the ones that humans will actually possibly notice. There’ve been a lot of behind-the-scenes patches to continue toward implementing future features. I continue to love this platform and what a great job the team is doing.

 Posted by at 5:06 PM  Tagged with:
Jan 232013

This post is not just a note about the changes in yesterday’s Kuma push to the MDN web site, but also serves to explain a change to our deployment process. The MDN development team is switching to a “continuous deployment” model, where new changes will be pushed to production as soon as they’re ready, instead of batching them.

Because of that, I won’t be blogging every single push anymore. Instead, I’ll mention specific new features as they’re ready for you to use, if they’re of major interest, or I’ll batch pushes together and mention the little but still interesting things all at once.

However, we do have a few interesting things in this new push, so I’ll mention those today:

  • The object returned by the wiki.getPage() KumaScript function now includes a translations array of objects that describe each translated version of the page. Each object in the array has three values:
    • locale — the locale of the translation
    • title — the translation’s page title
    • url — the URL of the translated page
  • The “revert this page” confirmation now shows the tag changes that will result from the reversion.
  • The “needs technical review” and “needs editorial review” banners are now much less scary looking; instead of being red, they’re a softer yellow.
  • The old devnews RSS feed now redirects to an appropriate feed providing appropriate content from the Hacks blog.
  • Some style cleanup has been done to the static portions of the site.
  • The feedback link at the bottom of pages no longer links to our long-discontinued forums; instead, they link to a new page on the wiki that explains how to offer feedback, including how to file bugs, get into IRC, and that you can contribute fixes yourself.

A few nice improvements, and the new deployment plan is an interesting development!

 Posted by at 9:58 AM  Tagged with:
Jan 162013

We have a new Kuma platform update tonight! The new version features the following improvements:

  • The following JavaScript keywords are now recognized by the JavaScript syntax highlighter: class, enum, export, extends, interface, let, package, private, protected, static, and yield.
  • The favicon has been updated to get rid of spurious white pixels.
  • The link to the CSS Reference in the Learn section of the site has been updated.
  • Fixed a thumbnail hovering problem on the Dev Derby promotion.
  • Added to the Kuma API a new “toc” command, which returns an ordered HTML list representation of the table of contents for a page.
  • The “Save and Keep Editing” button no longer disappears when you reveal the page metadata editing fields.

Nothing major, but a few nice quality of life improvements.

The core MDN team has been meeting in Austin, Texas this week to plan development work for the next year. I’ll be blogging more about what we’ve come up with next week. We have Plans! Big Plans!

 Posted by at 11:28 PM  Tagged with:
Jan 102013

That’s right! Even though just earlier today I blogged about last night’s Kuma software update on the MDN web site, we have another one. I adore our development team. I could squee all day about this stuff, but instead, let’s have a look at what’s changed:

  • When moving a page, you can now change its title at the same time; this field was previously editable, but its new value was being ignored.
  • The Styles drop-down menu in the editor now includes the “standardSidebar” and “syntaxbox” styles; these are used to create right-floated call-out sidebars and the syntax boxes used near the top of the CSS and (soon) other reference pages, such as HTML.
  • Submenus no longer sometimes stick off the edge of your window if you’re using a right-to-left locale.
  • A formatting problem that could cause ugly wrapping of article version histories has been fixed.
  • More removal of cruft has been done on the development VM.

Not a lot of changes, but several that will be a real boon to select people. In particular, I’m personally thrilled by the improvement to the page move tool, since I’ve been doing a lot of organizational clean-up work lately, and this will streamline that work noticeably. I’m also happy about the update to the Style menu, since these styles are getting used more and more — and being able to avoid dropping into the source editor to apply them is a huge help!

The staff MDN writers and the MDN development team are meeting next week in Austin, Texas to talk about development plans for the next six months or so. I’m looking forward to seeing them all. These are excellent people, and it’s a privilege to work with them all.

 Posted by at 5:14 PM  Tagged with:
Jan 102013

We pushed an update to MDN’s Kuma platform last night. One nice, currently-useful change, one change that has more work left to be done before it’s ready to use, and a few behind-the-scenes tweaks you won’t notice yet.

  • Page moves are more clearly called out on the revision dashboard now, with a little box showing the source and destination pages on each relevant entry.
  • Fixed a bug with choosing a locale in Firefox in the translation UI.
  • The environment variables for a page now include information about which review tags are set on the page. This is a JavaScript Array.
  • Removed obsolete remnant bits of DekiWiki and switched to Ubuntu on our development VMs.
  • Reworked save page logic in preparation to bring back support for editing individual sections in addition to full-page editing.

There are some technical issues involved in getting these lists reported as actual arrays, but that’s something we do hope to do soon.

Other than the bug fix and the revision dashboard change, most of these changes are behind-the-scenes for now (the VM changes and the save logic changes).

In addition, you can’t yet see that tag information for other pages (it’s only available via the current page’s environment variables list). I’m filing a bug for that right now; I didn’t clearly communicate the use cases for this to the development team. Oops.

 Posted by at 10:14 AM  Tagged with:
Jan 082013

We pushed a very small update to MDN’s Kuma software today. There’s only one change: if the text “bug X”, where “X” is a number, appears in an article revision comment, it’s turned into a Bugzilla link to bugzilla.mozilla.org, so you can quickly hop over to that bug for reference.

That’ll be a handy feature! I’ve been looking forward to it for a while now. Enjoy!

 Posted by at 3:53 PM  Tagged with:
Jan 042013

Why, hello there! It’s been several weeks since our last push of new code to MDN’s Kuma platform, so the list of changes in our new update is quite long. Let’s dive in and have a look!

Revision dashboard

  • A new filter by topic feature has been added; you can use this to see only documents that are in the HTML subtree, for example, if you’re trying to focus on reviewing changes to HTML documentation.
  • You can now share links to filtered versions of the revision dashboard; the code now uses pushstate to track the required information. For example, you can follow this link to see a list of changes to the HTML documentation in the English locale.
  • The vertical position of the locale information has been improved.
  • Fixed an error that appears to have been getting triggered by Google’s crawl hitting the dashboard.

Wiki improvements

  • The new “Clone this page” option has been added to the “This page” menu. You can use this to duplicate the current page in its entirety, including its tags. This will be incredibly useful for using pre-defined page layouts for references and other documents!
  • The width and height attributes are now accepted on <img> elements.
  • The <ins> and <del> elements now allow the datetime attribute.
  • The cite attribute is now allowed on the <q>, <blockquote>, <ins>, and <del> elements.
  • The Bengali (bn-BD) locale is now supported.
  • You can now see a list of all tags: https://developer.mozilla.org/en-US/docs/tags

Other improvements and fixes

  • Parts of the work to restructure our file attachment management have been integrated. More needs to be done, but we’re well on our way!
  • The sitemap was not valid, and was therefore being ignored by Google. Fixed.
  • The “create a page on 404” functionality is no longer triggered if the viewer isn’t logged in.
  • SEO attributes have been added.
  • Attached images are losslessly compressed to improve page load times.
  • Page lists no longer include redirects or templates.
  • Promotional content has been updated.

So this is a huge update, and it’s got some really nice stuff in it. Stay tuned! There’s more to come!

 Posted by at 11:14 AM  Tagged with:
Dec 122012

We have a glorious new update to Kuma today! This update adds some nice improvements to the MDN wiki:

  • The initial page moving feature has landed! It’s still very rough around the edges, and there are follow-up bugs to be addressed. Because of that, it’s disabled for everyone but administrators for now. But it’s getting there, and this is a big day we’ve been waiting for for a long time.
  • The table in the revision dashboard has been reorganized a bit; the Comment column has been removed, and the comment is now displayed underneath the article’s title, when there’s a comment. In addition, the locale has been moved to the right side of the article title column.
  • The Revision Diff section in the revision dashboard now shows the title of the article, so you have it handy down below if you’ve scrolled the list of articles off the screen.
  • RSS feeds now default to 50 items being returned; you can change this by specifying a limit parameter in the request. We plan to add an offset parameter eventually as well, so you can get feed data in batches.
  • We added support for CORS to the site that hosts sample code, to avoid errors that occurred when trying to load assets (such as fonts for @font-face).
  • The datetime attribute has been white-listed, so it can be used.
  • Updated the Persona authentication code.

This is a huge update! We attempted to land most of it on Friday but ran into a significant bug that required the update to be rolled back and repaired. That’s now done, and things look good. We hope to open page moving up more soon, once it’s had more testing. Stay tuned!

 Posted by at 2:19 PM  Tagged with:
Dec 052012

We did a second push of the Kuma code to MDN last night to pick up a few bonus changes!

The “sample finder”

The biggest new feature is the addition of a new button has been added to the toolbar to let you insert an <iframe> for any code sample from anywhere on MDN. Simply click the Insert code sample iFrame button in the toolbar. This will present you with a dialog box like the following:

You can choose any section in the current document from which to pull sample code (which comes from the <pre> blocks inside that section). You can even choose to pull the sample from a different article entirely! This lets you reuse samples, share bits of code across pages, and so forth.

But wait, there’s more!

We have a few other updates, too!

  • One of the fixes from earlier yesterday, to set minimum widths for columns in the revision dashboard, didn’t actually get picked up in the first push. It did, however, in the second.
  • There have been more updates to the copy for the February Dev Derby.
  • We reverted some of the changes to the Persona login, because the change to using the new API was not as simple has we’d been led to believe.

We continue to drive ever onward, forward, and upward!

 Posted by at 11:26 AM  Tagged with: