Nov 122013

A new push of the Kuma code to the MDN web site was done yesterday, followed by another this morning. Here’s a quick look at what’s new.

  • Page moving has landed again at last. This is for now available only to administrators, I believe. The emails that let you know when page moves have finished don’t always send correctly due to what appears to be a server configuration problem. We have a bug filed for IT to look at it.
  • The Elastic Search indexing task has been rate-limited so it doesn’t chew up so many resources that it blocks other tasks from running.
  • We can add the attribute data-default-state="open" to quicklink “folder” items to make them default to open rather than closed.
  • Redirects and user pages are no longer shown in search results, which makes the search results much better. This will require a site index rebuild, so you may not see this improvement right away.
  • Names in user profiles now have wider letter spacing.
  • The capitalization of the “See also” heading in the sidebar above quicklinks has been corrected, and the link color is being enforced on the quicklinks box.
  • Fixed the demo studio links to draw above the spotlight image so that they’re clickable.
  • Content tables now all have a bottom margin.
  • The “Previous Page” and “Next Page” buttons in the search results are now just “Previous” and “Next”.
  • Other assorted style cleanup work has been done.

This is a big deal, in that we finally have page moves. We’ll use it cautiously at first, to avoid (hopefully) any disasters if new bugs are found. But we’re pretty confident this time, other than the server issue with failing confirmation emails.

 Posted by at 1:04 PM  Tagged with:
Nov 082013

We’ve just pushed another update to the Kuma platform deployed on MDN! Let’s take a look at an overview of what’s been done:

  • Page move now correctly disallows attempts to move pages to a URL for which there is no parent page.
  • Page move is now constrained to a single locale.
  • Template (macro) pages no longer have a language selection menu, since these are always edited in the en-US locale and are localized in their code.
  • When viewing on a mobile phone, MDN is now presented in a 1-column view.
  • The list of search filters on search results pages now has an empty checkbox drawn when not selected; previously there was no indicator until you selected each filter.
  • The height of the sidebar “See also” box has been corrected in “small desktop” layout.
  • Updated the appearance of the search box in the header area.
  • Rendering of the language drop-down has been improved so that parentheses are no longer in the wrong place in RTL languages.
  • Corrected the layout of the search results page in right-to-left locales.
  • Improve heading structure on the homepage to put items in the correct order for screen readers.
  • Microdata has been implemented for breadcrumbs for Google search results.
  • The left margin has been removed on the first navigation item, and its submenu shadow has been lightened.
  • The home-globe.svg image used on the home page has been replaced with a PNG to save bandwidth.
  • PNG images have been optimized to save bandwidth.
  • The padding at the bottom of the <li> element has been tightened up.
  • Platform localization docs have been updated a bit.

Whew! That’s quite a list! As you can see, page move is getting there. It’s technically done, but we’ve run into a clash with another process that needs to be resolved before we start using it in the field. Soon, I hope!

 Posted by at 3:39 PM  Tagged with:
Nov 052013

We pushed an MDN update on Friday, and it has some improvements you’ll appreciate!

  • CKEditor is no longer loaded for every page, even when you’re not editing. This speeds page load times significantly!
  • Page moving is inching closer to finished. We had it done, but found another bug; this one minor. We hope to nail it down today or tomorrow.
  • Column widths have been tweaked a bit, along with minimum sizes. This should improve overall readability of content on MDN. We’re still tweaking these, so expect future changes. But let us know what you think!

In addition, we’ve just pushed a new build of Kuma to MDN’s servers, and I’m here to share some of the more interesting bits with you, as usual!

  • Search results pages now tell you how many matches were found.
  • The drop-down menus in the header area now have a border and drop shadow as intended.
  • Fixes to the display layout for RTL languages. There’s more left to do here, but we’re making progress.
  • Accessibility improvements, including support for skipping links using VoiceOver and making the search box more accessible.
  • The “See also” text in quicklinks is now more obviously a heading.
  • Global notification messages from the site administrators now display correctly in the redesigned look and feel.
  • The login text at the top of the page has been made slightly larger to be easier to see.
  • Some internal tweaks have been done to improve testing functionality.

We’re about ready to begin seriously working on content clean-up to get our content to use the new styles that Sean Martell has created for us. I think that work will begin in earnest today or tomorrow. On top of all that, we’re doing great things with the new quicklinks functionality in the sidebar. Check out, for example, the documentation for the JavaScript Number object. Note how you can browse the entire object in the sidebar. Awesome!

This is an exciting time!

 Posted by at 4:18 PM  Tagged with:
Nov 012013

We’ve pushed another update to MDN’s Kuma installation this morning. Page load performance should be improved, and the site’s appearance on Firefox OS and other mobile devices should be better (although not yet ideal).

  • The home page now uses mobile CSS on Firefox OS devices.
  • Search-related accessibility is improved.
  • CKEditor is now only loaded when needed, instead of on every page.
  • Moved a lot of the wiki content’s CSS into site CSS files.
  • Medium-sized screens’ CSS updated.
  • Sizes of text in certain lists have been reduced.

I expect (and fervently hope for) a second push today, to get page moving up and running again. I’ll let you know if/when that happens!

 Posted by at 12:37 PM  Tagged with: