Presented by: James Dempsey, Dave Morris, Marco Molinaro, Ole Streicher, François Bonnarel
Agenda
- Introduction - Moving standards to GitHub
- Repository approach - master is live - shows activity on the standard. Use tags based on the documentation standards - named after current filename standards.
- Roles for repository:
raising issues & PRs | Anyone |
reviewing & merging PRs | |
creating new repos | |
- Demonstration of workflow based on real issue (DataLink or ADQL)
- Fork repository
- Raise issue in main repository
- Branch in fork
- Commit fix to branch
- Raise pull request to main
- Editor reviews
- Editor merges
- Lorem ipsum standard - all have access to raise pull requests, merge etc
- Future possibilities: CI integration with Travis
- Discussion points:
- License
- No PDFs in git
- What to do with legacy Word docs
- Rebase mechanism