/webrtc-w3c

W3C Specification for WebRTC

Primary LanguageJavaScript

NOTA BENE ( http://bit.ly/VoL9Qt )

To Reflow the Spec

To format the draft use something like

tidy --quiet y -utf8 --vertical-space y --tidy-mark n -indent -wrap 80

To Generate a Version

To generate the dated version of the specification:

  • If releasing a getusermedia draft, in getusermedia.js update the "prevED" line to point to the previous dated draft (i.e., the one currently available as the editor's draft on dev.w3.org).

  • If releasing a webrtc draft, in webrtc.js update the "prevED" line to point to the previous dated draft (i.e., the one currently available as the editor's draft on dev.w3.org).

  • Create a new directory in archives corresponding to the new release day (YYYYMMDD)

  • Open the document in Firefox.

  • Press CTRL-ALT-SHIFT-S.

  • Select "Save as HMTL" from dialog box.

  • Save the file as the base name in your new archive directory like archives/20130320/getusermedia.html

  • Copy all associated resources (images/) into the newly created archive directory.

  • In the archive file, search for and edit the link for "This version" and fix to point at the new dated version of the spec

  • Add the new archives/YYYYMMDD directory to git and make a commit.

  • Create a new version tag: $ git tag -m "Editor's draft YYYYMMDD." vYYYYMMDD

  • Push the commit and the new tag to the git repo: $ git push --tags origin master

  • Once everyone is happy, the files need to be copied to the cvs repository. Start by updating your copy (use -d option to get new directories): $ cvs update -d

  • Confirm that you have all recent archive directories. If any are missing, to be safe re-checkout your entire cvs directory from scratch to ensure that you have everything.

  • Copy the following from your git directory to the cvs editor/ directory

  • images/
  • archives/YYYYMMDD (the new archived directory created above)
  • If you are releasing a webrtc draft, also copy the following files into the "sources" subdirectory on CVS for archival purposes:
  • webrtc.html, webrtc.js, and webrtc.css Also, within the CVS directory create a soft symbolic link from your new archive dated version: $ ln -s archives/20130320/webrtc.html . (if you can't do symlinks, just copy the file)
  • If you are releasing a getusermedia draft, also copy the following files into the "sources" subdirectory on CVS for archival purposes:
  • getusermedia.html, getusermedia.js, and getusermedia.css Also, within the CVS directory create a soft symbolic link from your new archive dated version: $ ln -s archives/20130320/getusermedia.html . (if you can't do symlinks, just copy the file)
  • Add the new archive directory (with content) to cvs: $ find archives/YYYYMMDD -type d | xargs cvs add $ find archives/YYYYMMDD -type f | grep -v CVS | xargs cvs add

  • Confirm what will be committed: $ cvs -qn update

  • Commit new directory and changed files (...): $ cvs commit -m "Added YYYYMMDD archived version." archives/YYYYMMDD/ ...

  • Send an email to the corresponding lists to announce the new release (proposed template below).

To Annouce a Version

Email template (use it if you like):

Hi

A new dated version of the Editors' draft is available.

Dated version: http://dev.w3.org/2011/webrtc/editor/archives//.html Living document: http://dev.w3.org/2011/webrtc/editor/.html

Changes include:

  • ...
  • ...

Please review and provide feedback.

(for the editors)

See Work Flow

Stories in Ready