User:Dria/Feature page query examples: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
mNo edit summary
 
(17 intermediate revisions by the same user not shown)
Line 2: Line 2:
I won't go into a whole lot of detail since I've already blogged fairly extensively about this ([http://blog.mozilla.com/products/2011/06/01/feature-pages-lists-wikis-oh-my/ here], [http://blog.mozilla.com/products/2011/06/06/new-feature-page-proposal/ here], and [http://blog.mozilla.com/products/2011/07/04/new-feature-page-system-coming-this-week/ here]), so here's the ''tl;dr'' version:
I won't go into a whole lot of detail since I've already blogged fairly extensively about this ([http://blog.mozilla.com/products/2011/06/01/feature-pages-lists-wikis-oh-my/ here], [http://blog.mozilla.com/products/2011/06/06/new-feature-page-proposal/ here], and [http://blog.mozilla.com/products/2011/07/04/new-feature-page-system-coming-this-week/ here]), so here's the ''tl;dr'' version:


# The old feature pages worked well enough to get us through our first release cycle in the new Train Model world, but fundamentally kinda suck.
# 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.
# We have launched out first iteration on the system, with a more logical page structure and using much smarter tools. It's still the wiki, but the wiki with a couple of completely badass add-ons ([http://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki this one], and [http://www.mediawiki.org/wiki/Extension:Semantic_Forms this one]).
# 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 ([http://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki this one], and [http://www.mediawiki.org/wiki/Extension:Semantic_Forms this one]).
# The new feature pages can be created and edited using a form, and they also support database-like queries for automatically generating lists, alternate views, and etc.
# The most important benefits are:
## New feature pages can be created and edited using a simple web form
## 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? ==
== Forms? In a wiki? ==
Line 10: Line 14:
# Go here: '''[[Features/Feature_page_demo | Feature page demo]]'''
# Go here: '''[[Features/Feature_page_demo | Feature page demo]]'''
# Click the "Edit with form" link at the top
# Click the "Edit with form" link at the top
# Gasp in surprise and amazement
# 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.
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 ([[User:Dria|Deb]]) if you have questions.


=== Creating new feature pages ===
=== Creating new feature pages ===
But you want to create a new feature page?  No problem!
Do you want to create a new feature page?  It's super easy!
# Go here: '''[[Features/Create_new]]'''
# Go here: '''[[Features/Create_new]]'''
# Follow the directions
# Follow the directions (4 steps, very simple)
# Ta dah!
# Ta dah!


== Queries? What? ==
== Queries? What? ==
The new system allows us query the feature pages and return results based on a [[Features/Feature_page_queryable_properties | variety of queryable properties]] in the pages themselves.
The new system allows us query the feature pages and return results based on a [[Features/Feature_page_properties | 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 pretty straightforward and fairly powerful.
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.


=== Example queries ===
=== Examples ===
* [[User:Dria/Feature page query examples/Firefox Desktop feature list | Firefox Desktop feature list]]
* [[User:Dria/Feature page query examples/Firefox Desktop feature list | Firefox Desktop feature list]]
* [[User:Dria/Feature page query examples/Mobile Firefox 7 table|Release Tracking table for Firefox 7: Mobile]]
* [[User:Dria/Feature page query examples/Mobile Firefox 7 table|Release Tracking table for Firefox 7: Mobile]]
Line 31: Line 38:
* [[User:Dria/Feature page query examples/Security Team tracking list|Security Team tracking list]]
* [[User:Dria/Feature page query examples/Security Team tracking list|Security Team tracking list]]
* [[User:Dria/Feature page query examples/Platform Team list | Platform team list]]
* [[User:Dria/Feature page query examples/Platform Team list | Platform team list]]
* [[User:Dria/Feature page query examples/Product Team tracking list | Product team tracking list]]
* ''...more to come as I experiment a little''


For more information about queries, see the add-on's [http://semantic-mediawiki.org/wiki/Help:Inline_queries query documentation].
For more information about queries, see the add-on's [http://semantic-mediawiki.org/wiki/Help:Inline_queries query documentation].


If you have any questions, ping [[User:Dria|Deb]] in IRC, IM, or email.
If you have any questions, ping [[User:Dria|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 ([[User:Dria|Deb]]) and I'll see what we can do.

Latest revision as of 22:34, 14 July 2011

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.