How to contribute to cambridge-ceu
Assuming you have registered a GitHub account, simply contact owner of a repository to add yourself as a contributor.
As adapted from Apress, a more general approach involves the following steps:
- Make sure you have a GitHub account.
- Fork a repository.
- Create a new branch on which to make your change, e.g.
git checkout -b your_initials_or_description - Commit your change. Include a commit message describing the correction. Please note that if your commit message is not clear, the correction will not be accepted.
- Submit a pull request from your_initials_or_description.
An example is given in Notes.md. More generally, it would be similar to these instructions to GDAL.
Corporate/organisational contributors
- Alibaba, https://github.com/alibaba
- Apple, https://github.com/apple
- Baidu, https://github.com/baidu
- Cambridge University, https://github.com/cambridgeuniversity (SRCF mod_ucam_webauth)
- Facebook, https://github.com/facebook
- FinnGen, https://github.com/FINNGEN
- Google, https://github.com/google (https://github.com/google-deepmind)
- HDR UK, https://github.com/hdruk
- Huawei, https://github.com/huawei
- MicroSoft, https://github.com/microsoft and .NET platform, https://github.com/dotnet
- Mozilla, https://github.com/mozilla
- Oracle, https://github.com/oracle
- Sanger, https://github.com/sanger
- Tencent, https://github.com/tencent
- Wiley, https://github.com/wiley
Technical guides and enhancements
- GitHub Guides including Hello world!, learning branching, git-scm documentation including Reference.
- Git(Kraken) tutorials.
- Enhanced GitHub, GitHub Dark Theme, Octotree, sourcegraph and Widescreen for GitHub for Google Chrome.
- GUI / IDE, HelloGitHub, awesome-GitHub, Run your blog on GitHub Pages with Python.
- git-extras.
- github-mermaid-extension
- git recall.
- GitHub token and Connection with ssh.
- Markdown Guide, Markdown reference by Typora (A hooking example for NodeInject).
- quarto Guide, https://quarto.org/docs/guide/
- Read the Docs Sphinx Theme and jekyll-rtd-theme (web)
CAUTION (legacy) -- there are issues under cardio on GitHub synchronisation so it is appropriate to use git pull but not git push which can replace files on the server with empty ones for no reasons. Sometimes it is necessary to disable the pop-up window as described in Notes.md.
Policies
This is in line with or somewhat mirrors University's policies for HPC.
References
Blischak JD, Davenport ER, Wilson G. A Quick Introduction to Version Control with Git and GitHub. PLoS Comput Biol 2016, https://doi.org/10.1371/journal.pcbi.1004668.
Chacon S, Straub B. Pro Git, 2e. Apress, 2014, https://link.springer.com/book/10.1007%2F978-1-4842-0076-6.
GitHub education and AWS Educate at the university https://help.uis.cam.ac.uk/resources/comms/archived-campaigns/github-aws, courses.
Acknowledgment
Thanks to Amy Mason for links on learning brachnes and University training courses.