From W3C Wiki
Jump to: navigation, search

This article is a stub. You can help the W3C wiki by expanding it.

GitHub is one of several tools in use by W3C groups and participants.


Best Practices

What are best practices for use of Github in W3C efforts?

In Working Groups

See for example (and feel free to re-use for your own W3C groups!)

In General

ISSUE: We should find a mechanism to remind all people who show up at the Github repository for a W3C WG Spec that we want contributions from Members or Invited Experts. Participants who are not IEs or from Member organizations who would like to make contributions should explore joining or becoming an IE.

Other issues

  • Is there a policy document (or similar) covering the use of Github versus W3C-hosted version control? (and presumably technology preference is a factor in that, but not the only factor)

... add your question/issue here

  • people involved in W3C Working Groups have W3C Account; having them using github require a separate GitHub account?
    • A: Yes
  • If a W3C group uses github as its basis of collaboration, participation in the group is subject to github's privacy policies etc. When is that a reasonable trade-off?
    • Use of git itself is decentralized so participants can collaborate directly with peers as alternative to going through github. But facilities such as issue tracking and pull requests are not; they necessarily involve use of github's web site.
  • we need infrastructure to use github to develop content, but have it published on a URI
  • how do we ensure that we keep a log of the interactions that happen on github? (if only for historical purposes)
    • A: a git repository would seem to suffice as its own log; for issues, there's an API. Presumably the API suffices for pull requests etc. as well.
  • centralized interactions on services made it (somewhat) easier to search for particular items and topics; having these interactions spread across multiple uncoordinated github repositories makes it harder

See Also