User:Dria/Feature page query examples

From MozillaWiki
Jump to: navigation, search

New feature pages

I won't go into a whole lot of detail since I've already blogged fairly extensively about this (here, here, and here), so here's the tl;dr version:

  1. The old feature pages worked well enough to get us through our first release cycle in the new Train Model world, but they fundamentally kinda sucked.
  2. I learned a lot in the process, and I've now launched the second version of the system, which includes a more logical page structure and uses much smarter tools. It's still the wiki, but it's the wiki with a couple of completely badass add-ons (this one, and this one).
  3. The most important benefits are:
    1. New feature pages can be created and edited using a simple web form
    2. The resulting feature pages support database-like queries for automatically generating lists, alternate views, and etc.

In other words: we no longer have to manually update release trackers, feature lists, or our own custom lists, because we can just build custom queries to do all of these things for us.

Forms? In a wiki?

It's true! Here's a demo!

  1. Go here: Feature page demo
  2. Click the "Edit with form" link at the top
  3. Gasp with surprise and delight

Any feature page created with the new system will have the "Edit with form" link at the top. I strongly suggest you use the form because editing the raw text is significantly crappier and more error prone.

Migrating the old to the new

Unfortunately, the old pages don't work with the new system at all -- and we can't use the form to edit/update them -- so all still-relevant feature pages need to be migrated to the new system. I'm in the process of doing this, but if you would like to migrate your own please feel free. Ping me (Deb) if you have questions.

Creating new feature pages

Do you want to create a new feature page? It's super easy!

  1. Go here: Features/Create_new
  2. Follow the directions (4 steps, very simple)
  3. Ta dah!

Queries? What?

The new system allows us query the feature pages and return results based on a variety of queryable properties in the pages themselves.

Here are some example queries and their output. Feel free to "edit" any of these pages to check out the source code for the queries -- they're simple and powerful.

Examples

For more information about queries, see the add-on's query documentation.

If you have any questions, ping Deb in IRC, IM, or email.

Flexibility

Turns out this system is easy to tweak and augment. If you have a particular thing you would like to do with these, or some bits of data you would like to add to the pages, ping me (Deb) and I'll see what we can do.