GitHub: Difference between revisions
(update bugzilla, add bmo) |
(Highlight importance of setting a team fro admin rights during transfer) |
||
| Line 1: | Line 1: | ||
This page is specifically about [https://github.com/mozilla the "mozilla" organization on github]. There are several other github organizations you may be interested in, cf. the incomplete list [[#other_github|below]]. | This page is specifically about [https://github.com/mozilla the "mozilla" organization on github]. There are several other github organizations you may be interested in, cf. the incomplete list [[#other_github|below]]. | ||
<div id="contact"> | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| Line 33: | Line 33: | ||
If you have created a repo on your own account (for example, myuser/myrepo) and it should live under the Mozilla organization, here are the steps: | If you have created a repo on your own account (for example, myuser/myrepo) and it should live under the Mozilla organization, here are the steps: | ||
# If you're not a member of any team, talk to an org admin. | # If you're not a member of any team, talk to an [[#contact|org admin]]. | ||
# Under the repo admin, transfer ownership to the Mozilla organization. If you don't see this option, return to step 1. | # Under the repo admin, transfer ownership to the Mozilla organization. If you don't see this option, return to step 1. | ||
# Choose which teams should be given admin privileges. If you don't chose any you will lose push access to the repo and have to talk to an org admin. | # Choose which teams should be given admin privileges. '''IMPORTANT: choose at least one.''' If you don't chose any you will lose push access to the repo and have to talk to an [[#contact|org admin]]. | ||
# Fork the repo from Mozilla (mozilla/myrepo) back to your account (recreating myuser/myrepo). While the transferred repo becomes the root of the network on Github (e.g. all forks are now forks of mozilla/myrepo) other users may be pointing to your repo by URL. | # Fork the repo from Mozilla (mozilla/myrepo) back to your account (recreating myuser/myrepo). While the transferred repo becomes the root of the network on Github (e.g. all forks are now forks of mozilla/myrepo) other users may be pointing to your repo by URL. | ||
# Add the appropriate teams to the new Mozilla repo or ask an org admin if you lost ownership. | # Add the appropriate teams to the new Mozilla repo or ask an [[#contact|org admin]] if you lost ownership. | ||
=== Do I need to be an owner to create repositories? === | === Do I need to be an owner to create repositories? === | ||
Revision as of 22:20, 28 January 2016
This page is specifically about the "mozilla" organization on github. There are several other github organizations you may be interested in, cf. the incomplete list below.
 Got a question?
|
|---|
Email github-owners  mozilla.org irc #github on moznet |
Recommendations and FAQ
Where should I ask additional questions?
- Send an email to github-owners mozilla.org and we'll respond right away! We're also available on #github on irc.
How do I hook up a new 3rd party application to a repository in the mozilla org?
- Authorizing an application to work with GitHub utilizes the permissions your account has -- so, any repositories you have access to the application will have access to as well. If you want to grant access to an application that no one else has used with the Mozilla organization yet you'll see a "Request access" button during the set up flow. You'll need to click that button to request approval. See below for an example:
Reviewing owners and permissions
As an owner or repository admin you're responsible for maintaining the list of people with access to your projects. Please be active and prudent about maintaining this list.
Can I be an Owner of the Mozilla Organization?
The Owners group on github has complete administrative power and will be limited to a minimal number of people and reviewed regularly. If a person is an owner they are expected to actively participate in the group and assist others as requested. Owners will be added as a need arises (for example, support in another timezone) as determined by the current owners.
Should I make a separate github organization or just create a repository in an existing one?
This is a personal preference. If you have a large enough project or organization feel free. We suggest you use the strategies and recommendations here as a model to manage the details.
Forking vs Transfering
Do not "fork" a repository into a Mozilla organization. Doing so gives every team in the org rights to it.
If you have created a repo on your own account (for example, myuser/myrepo) and it should live under the Mozilla organization, here are the steps:
- If you're not a member of any team, talk to an org admin.
- Under the repo admin, transfer ownership to the Mozilla organization. If you don't see this option, return to step 1.
- Choose which teams should be given admin privileges. IMPORTANT: choose at least one. If you don't chose any you will lose push access to the repo and have to talk to an org admin.
- Fork the repo from Mozilla (mozilla/myrepo) back to your account (recreating myuser/myrepo). While the transferred repo becomes the root of the network on Github (e.g. all forks are now forks of mozilla/myrepo) other users may be pointing to your repo by URL.
- Add the appropriate teams to the new Mozilla repo or ask an org admin if you lost ownership.
Do I need to be an owner to create repositories?
No. If a person has read/write access to another repository in that organization they can make more repositories in that organization. However, it's preferred that you create repositories in the context of a team.
Are there requirements for when or how I should create a new team?
No. When requirements were proposed they all seemed too rigid and time consuming. Instead we recommend staying flexible and using good naming and documentation for projects (similar to naming CSS classes or variables).
On large teams we recommend you separate teams for read/write and repository administration.
No, there are plenty of Mozilla-related "organizations" on github. As a rule of thumb, initiatives that create a large number of sub-repositories will create their own "organization". Here is a (probably incomplete) list of them:
| Organization | Description | Contact Owner |
|---|---|---|
| mozilla-it | Mozilla IT's repositories | ? |
| bugzilla | Bugzilla (the product) - read-only mirror | ? |
| bugzilla.mozilla.org | bugzilla.mozilla.org (BMO) - read-only mirror | glob (glob) |
| drumbeat-badge-sprint | Drumbeat Badge Lab | ? |
| hackasaurus | Hackasaurus | ? |
| jetpack-labs | Jetpack Labs | ? |
| mdn | Mozilla Developer Network | Luke Crouch (groovecoder) |
| mozbrick | Mozilla Brick (web components library) | ? |
| mozilla-appmaker | Mozilla Appmaker | ? |
| mozilla-b2g | Mozilla Boot2Gecko / Firefox OS | ? |
| mozilla-comm | Calendaring and Messaging related projects | ? |
| mozilla-cordova | Firefox OS Support for Apache Cordova | ? |
| mozilla-metrics | Mozilla Metrics | ? |
| mozilla-raptor | Mozilla Raptor / Firefox OS Performance | Eli Perelman (eliperelman), Rob Wood (rwood) |
| mozilla-services | Mozilla Services | mozilla-services owners |
| mozilla-svcops | Mozilla Cloud Services Ops | Daniel Thornton (relud) |
| MozillaTW | Mozilla Taiwan | ? |
| Mozilla-TWQA | Mozilla Taiwan QA | ? |
| mozillahispano | Mozilla Hispano | ? |
| MozillaSecurity | Mozilla Platform Fuzzing Team master repo with many fuzzing tools under it. | ? |
| MozillaWiki | MozillaWiki (wiki.mozilla.org) | Christie Koehler (ckoehler), Gordon P. Hemsley (gphemsley) |
| mozillayvr | Mozilla Vancouver @MozillaYVR | ? |
| mozfr | Mozilla Francophone | Pascal Chevrel https://mozillians.org/fr/u/pascalc/ |
| opennews | Knight-Mozilla OpenNews | ? |
| rust-lang | The Rust Programming Language | Aaron Turon (aturon) |
| servo | Servo (browser engine written in Rust) | Lars Bergstrom (larsberg), Jack Moffitt |
| tabulapdf | Tabula project (extract data from PDF files) | ? |
| webcompat | Web Compatibility Team | Mike Taylor (miketaylr) |
| mozilla-l10n | Mozilla l10n-drivers team | Pascal Chevrel https://mozillians.org/fr/u/pascalc/ |
Why, yes! In no particular order:
- https://github.com/kinetiknz/nestegg/ : WebM demuxer
- https://github.com/xiph/opus/ : Modern audio compression for the internet.
- https://github.com/webmproject/libvpx : Mirror only. Please do not send pull requests.
- https://github.com/campd/fxdt-adapters : Firefox Developer Tools protocol adapters
- https://github.com/kripken/emscripten : Emscripten: An LLVM-to-JavaScript Compiler
- https://github.com/bbondy/codefirefox : Video and exercise based tutorial site for coding Firefox and other Mozilla related technology
- https://github.com/nickdesaulniers/where-is-firefox-os : A map showing where in the world Firefox OS phones are being sold.
- https://github.com/jdm/bugsahoy : A landing page to make finding relevant bugs easier for new Mozilla contributors.
- https://github.com/w3c/web-platform-tests : Test Suites for Web Platform specifications
- https://github.com/w3c/wptserve : Web server designed for use with web-platform-tests
- https://github.com/w3c/wptrunner : Cross-browser and multi-platform test runner for web-platform-tests. Used in mozilla-central and servo.
- https://github.com/w3c/testharness.js : (no description)
- https://github.com/jdm/asknot : Ask not what Mozilla can do for you but what you can do for Mozilla.
- MozDef: Mozilla Defense Platform.