Oct 262012
 

We’ve got a fresh update to the Kuma software that powers the MDN wiki for you! There’s not a lot of visible stuff here, but a lot is going on:

  • The “Sort table” option in the contextual menu that appears in the editor when you right-click on a table has returned!
  • The first preview version of our revision dashboard has been implemented. It’s nowhere near finished yet, but it’s a start. Because the current implementation is very low performance, access is currently heavily restricted to a few select people. We’ll open it up to everyone once the performance is in a safer place.
  • The wiki is now configured to use Mozilla’s content delivery network (CDN) to improve performance. Speed should be very noticeably improved now, especially if you’re outside North America.

The revision dashboard is a new feature we’re working on that will provide a one-stop page where you can go to see all the most recent changes to the site. You can see a mock-up for what it will eventually more or less look like:

A mockup of what the revisions dashboard will more or less look like eventually

And here’s what the current preview version actually looks like:

A screenshot of the current build of the revisions dashboard

The appearance is currently extremely rough, and none of the filters or features for actually manipulating the revisions in any way have been put into place yet.

The top area is a list of all of the most recent changes to the site (newest revision first, getting progressively older in each row in the list). Clicking on a change displays the diff for that change below.

This provides a convenient way to quickly review changes to the site.

Over time, this dashboard will offer features for reverting changes, banning users (if you’re an admin), quickly getting to pages to do an edit or view the page’s full history, and so forth. In addition, eventually we will find and use a better diff display that shows you a better look at the page. At any rate, this is very exciting progress, and I promise you’ll get to use this yourself before too long!

 Posted by at 4:02 PM  Tagged with:
Oct 112012
 

Yep! Even though we did a push yesterday, we have another one today! A few things that needed extra testing, or weren’t quite ready yesterday are ready now. There’s a lot of stuff here in preparation for the launch of the first pass of our live sample support! These are exciting times!

  • Fixed a bug that was causing page edits to sometimes create faulty redirects to their parents.
  • Initial work on the live sample view. I will blog separately about this once it’s ready to actually use. This is one of the things I’ve been looking forward to for years!
  • The CSS class names used by the syntax highlighter are better; this is related to the sample view work.
  • All site images have been further optimized (losslessly), thereby reducing size by about 10%.

So progress is progress! We should have the ability to actually use the new live sample features soon!

 Posted by at 5:56 PM  Tagged with:
Oct 102012
 

We have a new update to the Kuma software that drives the MDN site today! This is an interesting assortment of changes, most of which you probably won’t directly notice, but should improve the site on a general level.

  • MDN now has a sitemap.xml file, which is automatically updated periodically. This should improve SEO, possibly significantly.
  • RSS feeds were being generated based on the wrong timestamp, resulting in spurious entries in the feeds being created whenever anyone force-refreshed a page. Now this won’t happen anymore.
  • The keyboard shortcuts for “save” and “save-and-exit” have been swapped, so that they match what we intended.
  • A lot of back-end work has been done toward implementing page moving. It’s not yet exposed to users, though.
  • The content of the <title> of pages on MDN has been changed slightly to improve legibility.
  • The <ruby>, <rp>, and <rt> elements are now allowed in article contents.
  • The font-variant CSS property is now allowed in article contents.
  • A <dfn> element is now used on the slug box in the editor to provide an explanation of what the term “slug” means; this will help users understand how things are done a little better.
  • Some administrative code has been written to help repair some translated pages which are missing their breadcrumb trails.

There’s a lot of code here. In particular, a ton of work has been done toward implementing page moving. Just because you don’t see it yet doesn’t mean a lot of progress hasn’t been made. This should reach these golden shores soon!

Our development team continues to amaze me. There are some great updates coming soon. Prepare to enjoy some fabulous new features soon!

 Posted by at 2:17 PM  Tagged with:
Sep 212012
 

Yesterday afternoon, we pushed a new update to MDN’s Kuma software. This update got us tons of changes; it had been two weeks since our last push (which is, to date, the longest we’ve gone without an update since we launched the new platform). Here’s a rundown of what’s changed:

  • By default, all users now have permission to attach files to articles; instead of granting upload permission, we now remove it from individual users as needed.
  • Localizers can now edit the titles of translated articles (woohoo!).
  • The description of an attached image (as entered when adding the attachment) is now the default alt text for images.
  • The styles in the editor now more closely match the styles you see when reading content.
  • Special pages, like edit pages, history, compare, and translation pages, are now marked as not being things that Google should crawl and index. This will help some broken SEO and other issues.
  • When users try to log into MDN for the first time since our switch to Persona, and they don’t have an email address in their MDN configuration, they now get an appropriate message explaining what they need to do; previously, we had an unfortunate error condition here.
  • Inconsistencies in the markup of tables of contents have been corrected.
  • When pages skip heading levels, the table of contents now draws more attractively than before.
  • The template editor no longer displays bogus error icons by the line numbers in certain cases.
  • Using the <code> element in headings no longer breaks those headings’ entries in the table of contents.
  • Display of some text in the static Learn HTML page has been fixed.
 Posted by at 10:11 AM  Tagged with:
Sep 062012
 

We have a new update to the MDN Kuma wiki that’s just gone live this afternoon. There are a number of fixes for SEO as well a couple of editing experience changes that should be appreciated.

  • You can now add and remove tags while using the translation user interface.
  • The template editor displays properly again. Our update late last week inadvertently broke it.
  • An extra <h1> block that was harming SEO has been corrected.
  • Canonical links are now reported using <link rel=”canonical”> to further improve SEO.
  • Window titles are now suffixed with “MDN” instead of with “Mozilla Developer Network”. This both helps SEO (since people search on “MDN,” not “Mozilla Developer Network”). It also reduces the visibility of the Mozilla brand, which is important since much of our content is browser-agnostic.
  • Fixed some typos in September Dev Derby text.

A relatively modest update today. However, we continue to fight the good fight to improve our Google juice, while at the same time gradually bringing new features to our community.

 Posted by at 4:37 PM  Tagged with:
Sep 042012
 

I’m back from my week of PTO and just in time! We have a new Kuma wiki platform update today on MDN. To wit:

  • You can now choose SVG images when inserting images into articles. This will be great for diagrams as well as for the SVG reference documentation.
  • The syntax highlighter now has an option for C/C++. How we missed including this originally, I have no idea!
  • The default link in the link editor is now the “simplest” one; that is, the one with the shortest slug. This doesn’t yet make the default always the best choice, but it’s an improvement.
  • The “Revision content” button in a revision details page in the history system now actually shows you the content of the revision.
  • Some initial behind-the-scenes coding for the page moving system has been implemented. There’s more to come.
  • You can now use the class and style attributes the HTML <strong> element.
  • The name attribute is now allowed on <a> elements.
  • You can now use the start attribute on <ol> elements.
  • More MathML elements and attributes are on the editor’s white list. We’re gradually making our way toward being able to use MathML in page content.
  • You can no longer use quotes in page slugs.
  • User profile pages’ list of recent documentation activity now has correct URLs to the affected content.
  • Updated the text of the Dev Derby rules.

In all, another handy little update. Lots of tweaks to make things more pleasant to use, and to fix a few more little glitches in content around the site. This week, our development team is all back from their various vacations, so I have high hopes for great things!

 Posted by at 12:54 PM  Tagged with:
Aug 292012
 

Even though I’m taking time off from work this week, I still want to share the news that we have a new update to MDN’s Kuma wiki platform for you today! We have some nice improvements for you this time around:

  • If you accidentally leave an editor page (by clicking the back button or going to a new page using a bookmark or the URL bar), a draft of your current state is saved locally on your computer. Returning to the page will offer to restore that draft. The recently-added alert when leaving a page has been removed in favor of this change. This is freaking awesome stuff that I’m totally stoked to have!
  • The link editor now prefills the URL box with “/locale/docs/”, and when you tab to that field, the text entry point begins after that text (instead of selecting the existing content), so you can just start typing the rest of the URL. This should provide a subtle, but helpful, improvement to the amount of time it takes to create new links.
  • In-wiki redirects created using the REDIRECT syntax were previously, incorrectly, 302 temporary redirects. They are now 301 permanent redirects. This will improve SEO as well as being more semantically accurate.
  • A rule in the CSS for edit pages that was attempting to load a non-existent image has been corrected; this was adding up to 0.7 seconds to the load time of the edit page, every time, due to the delay caused while the 404 page was being loaded.
  • The text in the “Revision comment” box that explains what the box is for has been changed slightly. It’s probably not worth mentioning even; that’s how slightly it’s changed!

Our team continues to do fabulous work — and fully half of the development team is on vacation this week, so this just shows how great they are, since great stuff continues to happen anyway.

I’ll be back at work from my vacation week the day after Labor Day (that is, I’ll be back on September 4th). See you then!

 Posted by at 5:28 PM  Tagged with:
Aug 242012
 

ZOMG! We pushed a second update today. And not as a panic move, but because we have more, tested, features and enhancements to give you! To wit:

  • The user interface for reverting changes has been implemented. The history list now offers a Revert link next to each version of the article. Clicking this creates a new version of the article based on the version you selected.
  • The JavaScript code for the editor is no longer loaded if you’re not logged in; this will improve page load times if you’re not logged into the wiki.
  • The “Save and keep editing” button now clears the revision comment when clicked, so you don’t accidentally re-use a previous edit comment.
  • The label of the revision comment box has been corrected; it accidentally said “Review comment.”
  • The revision comment box has been moved above the tag editing area, since it will typically be used more often.
  • Fixed a broken image reference in the site CSS.

This is another nice set of usability improvements. It’s very exciting to be getting so much good stuff so quickly!

 Posted by at 6:22 PM  Tagged with:
Aug 242012
 

We’ve just pushed another modest update to the Kuma software that powers the MDN wiki. The biggest changes here are modest improvements that will affect our international community. Here’s a quick list of what’s changed:

  • Persona login support has been enabled for all locales, including those for which there’s no Persona translation at this time. Previously, we had a specific list of locales for which we supported logging in, which kept a lot of people from editing MDN. No more!
  • The text “BrowserID” has finally been corrected to “Persona” everywhere.
  • The <s> and <tfoot> elements are now on the editor’s whitelist.
  • Translation screens for right-to-left locales now put the original English text on the right instead of on the left; this should feel more natural for people in these locales.
  • Demo Studio has been updated to use the changed URLs for documentation post-Kuma launch.

As I said, this is a pretty modest update, but the login and localization improvements should make our localization community ever-so-slightly happier! Enjoy!

 Posted by at 2:23 PM  Tagged with:
Aug 222012
 

That’s right, everyone! We’ve got another update to the MDN wiki already, just one day after the last update! Before we get into today’s update, I’d like to note that yesterday’s caused a noticeable improvement to page load times. I’m quite pleased!

This update is, again, fairly small, but has some nice improvements that will impact productivity in helpful ways, so it was worth getting pushed to our production servers quickly.

Here’s a quick list of what’s new:

  • The revisions RSS feed has undergone the first round of updating to improve its usefulness; among other things, sequences of changes to the same document are now all included in one entry in the feed, and there’s now a side-by-side diff of the HTML, similar to the one in the in-site revision history. It is not yet pretty; however, its output is more useful and extensive. More work will be done over the next few weeks to make it better. We promise!
  • The site was serving up several HTML <meta> tags that served no useful purpose. These have been removed.
  • The copyright notice at the bottom of the page was not correct; it has been updated to read “© 2005-2012 Mozilla and individual contributors”.
  • A bit of JavaScript that was being loaded twice is now only loaded once.
  • A bug that caused the display of the parent of a page in the editor to be wrong if the parent has moved has been fixed. This is a step along the road to adding support for moving pages, which is coming Real Soon Now™.
  • Attributes for the <select> element are now whitelisted so that examples will work correctly.
  • The correct permission is now checked for letting users attach files to articles. This should help improve the availability of this feature!
  • The ability to delete a revision has been removed and has been replaced with a revert feature; you can now choose a version of an article to revert to. Doing so makes a copy of that version and makes a new version of the page with those contents. This makes undoing changes less destructive, and much safer. However, the UI for the revert feature has not landed yet. It will come very soon.
 Posted by at 5:45 PM  Tagged with: