On deploying next release of compatibility tables

Hi folks!

Just a note that we are ready to roll out the compatibility tables on the docs pages.

But before we do, its time for us to have an eye and see the feature in the test wiki before we make it live.

So here is what I’d like your feedback for; Follow some of the steps at "WHAT TO DO" below, and tell me if it makes sense and if you saw funny cases.

If nothing too funny happens, I’d like to deploy to the live wiki by next week.




WHAT’S NEXT

Other things are coming soon too, with this step in place, we will be allowing the community to edit the content from a GitHub repository at [0].

Later down the road, we will have to create a process to merge automated data from other sources along with the human entered ones. That is another project though.




WHAT TO DO:

Like I said, maybe there will be a few kinks to iron such as the how the table looks like. Those aren’t blocker to push to production on the live wiki but should be addressed first. 

Just reply to this thread if you have something to point out.



1. Go to the test wiki

See http://docs.webplatform.org/test/


2. Go to a page, and see the raw data and the generated table

For example:

- Go to a page such as [3], 
- Go to the raw data file [1], and search for the last part of the name in the URI (e.g. "font-stretch" for [3])

So, if we are on a page "/css/properties/front-stretch" [3], it’ll dig in the JSON through this path: `['data']['font-stretch']['contents']` and then will generate the tables based on that data.

The HTML should be reflecting. Ignore the "notes" section in [3] for now.



3. Go on random pages and see if something funky happens

All CSS properties pages in the test wiki has the template change [4] already. 



4. Optional: Play with creating compat tables in the playground page

NOTE: This requires you have an account in the live wiki though. 

Go to [2], and edit content. 

You can create compatibility tables by adding a tag similar to what you will see in [2].



  [0]: https://github.com/webplatform/compatibility-data
  [1]: http://docs.webplatform.org/compat/compat-mdn-human.json
  [2]: http://docs.webplatform.org/test/Tests/Compatibility_table_and_caching
  [3]: http://docs.webplatform.org/test/css/properties/font-stretch#Testing_CompaTables
  [4]: http://docs.webplatform.org/test/Template:CSS_Property

-- 
Regards,

Renoir Boulanger  |  Developer operations engineer
W3C  |  Web Platform Project

http://w3.org/people/#renoirbhttps://renoirboulanger.com/  ✪  @renoirb
~

Received on Wednesday, 2 July 2014 15:25:07 UTC