Re: TTML2 Default Branch, New ED Link

> For non-gh-pages branches, e.g., those used for PRs, etc., you will need to continue to use the rawgit.com<http://rawgit.com> entry point, e.g., [2], substituting branch-name with the desired value.
>
> [2] http://rawgit.com/w3c/ttml2/branch-name/spec/ttml2.html


Alternatively you can use git tools (command line, app, choose your favourite) to clone the repository locally and switch to the branch of interest, then open up the html file in your browser.

If you want to make a pull request, create a new branch from your preferred starting point (usually gh-pages), naming it something relevant, edit the XML source, build the HTML using ant according to the README instructions, check it looks okay, edit as needed, commit changes, push them to the repository ("sync" if you're using the github app) then make the pull request from your branch into the destination branch (usually gh-pages).

I say "usually gh-pages" since you can alternatively propose a change to another branch using the same method. If there's a pull request from that other branch into gh-pages, then merging your pull request will update the PR into gh-pages too.

Here's an example to illustrate that last paragraph of gibberish:

A) Xavier creates a Pull Request from branch "my-great-contribution" to gh-pages.
B) You review it and think you can improve it, but it's a slightly complicated improvement that could use separate review.
C) Rather than committing directly to "my-great-contribution" you create a "super-improvement" branch from the "my-great-contribution" branch.
D) You make your changes, commit them and push them.
E) You create a pull request from "super-improvement" branch to "my-great-contribution".
F) Everyone loves your work and your pull request gets merged into "my-great-contribution".
G) Now the state of the Pull Request from "my-great-contribution" into gh-pages is updated to include your improvement.
H) The Pull Request from "my-great-contribution" is merged and now gh-pages includes both Xavier's great contribution and your super improvement.

Incidentally, as long as the Pull Requests are made without squashing the commits all of the change history is retained from Xavier's work and your work.

By the way please don't name your branches this way! Something that reflects the actual content of the change is more helpful, and you can include the issue number. Plus in the PR description if you include words like "fixes #1234" then when the PR is merged into the gh-pages branch the issue will automatically be closed.

Nigel



From: Glenn Adams <glenn@skynav.com<mailto:glenn@skynav.com>>
Date: Thursday, 5 May 2016 23:14
To: TTWG <public-tt@w3.org<mailto:public-tt@w3.org>>
Subject: TTML2 Default Branch, New ED Link
Resent-From: <public-tt@w3.org<mailto:public-tt@w3.org>>
Resent-Date: Thursday, 5 May 2016 23:20

I have changed the default branch from master to gh-pages, to allow mirroring into the github.io<http://github.io> space. The former master branch has been deleted.

The new "Latest Editor's Copy" URI is now [1], which serves up the copy in the gh-pages branch.

[1] https://w3c.github.io/ttml2/spec/ttml2.html


For non-gh-pages branches, e.g., those used for PRs, etc., you will need to continue to use the rawgit.com<http://rawgit.com> entry point, e.g., [2], substituting branch-name with the desired value.

[2] http://rawgit.com/w3c/ttml2/branch-name/spec/ttml2.html




----------------------------

http://www.bbc.co.uk

This e-mail (and any attachments) is confidential and may contain personal views which are not the views of the BBC unless specifically stated.
If you have received it in error, please delete it from your system.
Do not use, copy or disclose the information in any way nor act in reliance on it and notify the sender immediately.
Please note that the BBC monitors e-mails sent or received.
Further communication will signify your consent to this.

---------------------