diff --git a/.github/CHANGELOG.md b/.github/CHANGELOG.md index ca6dd68..ca1c653 100644 --- a/.github/CHANGELOG.md +++ b/.github/CHANGELOG.md @@ -1,17 +1,17 @@ #VATNZ AIRAC Changelog + - [AIRAC 2013](#airac-2013) - - [Revision A (Initial Release)](#revision-a-initial-release) + - [Revision A (Initial)](#revision-a-initial) - [Revision B](#revision-b) - - [Revision C](#revision-c) - - [Revision D](#revision-d) - - [Revision E](#revision-e) -- [AIRAC 2101 ()](#airac-2101-) - - [2101 (Yet to be released)](#2101-yet-to-be-released) - + - [Revision C](#revision-c) + - [Revision D](#revision-d) + - [Revision E](#revision-e) +- [AIRAC 2014](#airac-2014) + - [Revision A (Initial)](#revision-a-initial-1) ## AIRAC 2013 -### Revision A (Initial Release) +### Revision A (Initial) Initial release of the NZ vatSys profile. @@ -29,18 +29,18 @@ No recorded changes. ### Revision E -1. Ground RADAR Views - NV, TG, RO, DN, NP, GS, AP, NR, NS and PM have all been added. Their associated ground radar has also been added. +1. Ground RADAR Views - NV, TG, RO, DN, NP, GS, AP, NR, NS and PM have all been added. Their associated ground radar has also been added. Thanks to Tom, Alek and Cam. -2. CPDLC updates - Small quality of life updates. +2. CPDLC updates - Small quality of life updates. Thanks to Zain. -3. ATIS Text-to-Speech - Now pulls clouds from the METAR string. +3. ATIS Text-to-Speech - Now pulls clouds from the METAR string. Thanks to Zain. -4. Airspace - Fixed an issue where waypoints with the same name that were outside of NZ were being included in a flightplan. +4. Airspace - Fixed an issue where waypoints with the same name that were outside of NZ were being included in a flightplan. Thanks to Alex. -## AIRAC 2101 +## AIRAC 2014 -### 2101 (Yet to be released) +### Revision A (Initial) -**Note:** This AIRAC release is yet to be finalised. There are minimal changes to the NZ AIP this cycle. +1. Ownership parameters of ACU positions. All TMA positions owned by default. Thanks to Zain. -1. Ownership parameters of ACU positions. All TMA positions owned by default. \ No newline at end of file +2. Initial release of [GitHub Contribution Guidelines](CONTRIBUTING.md). diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 0000000..4565f13 --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,68 @@ +# Welcome + + +- [Contributor License Agreement](#contributor-license-agreement) +- [Contributing](#contributing) + - [Contributing to the Dataset](#contributing-to-the-dataset) + - [Testing the Dataset, and your changes](#testing-the-dataset-and-your-changes) + - [Issue Tracking](#issue-tracking) + - [Pull Requests](#pull-requests) + - [Pull Request Guidelines](#pull-request-guidelines) + + +Welcome to the VATNZ Dataset repository. Thank you for offering your help to maintain the New Zealand Dataset. This document details the correct processes to follow in order to add your own code to the project. + +#### Contributor License Agreement + +By submitting code as an individual, you agree that VATNZ can use your ammendments, fixes, patches, changes modifications and submissions in the production of the New Zealand Dataset; and that the ownership of your submissions transfers to VATNZ in their entirety. + +## Contributing + +### Contributing to the Dataset + +If you're comfortable with contributing to Open Source projects on GitHub please ensure you read our expectations for issue tracking, feature proposals and merge requests. + +**Please avoid** adding AIRAC related commits until you've seen an issue raised for them. If an AIP Bulletin is released, the Controller Operations Director or a delegated individual will review it and raise an issue for the work to be completed. + +### Testing the Dataset, and your changes + +At the moment, the only way you can test your changes is by pointing the vatSys Profile to the development version. This can easily be done with [GitHub Desktop](https://desktop.github.com/) or the CLI. By pointing the vatSys Profile selector to the `Profile.xml ` of your development version. + +### Issue Tracking + +If you require support with the Dataset or vatSys, please utilise the #vatsys-discussion channel in the VATNZ Discord server. Issues specifically regarding the features and functions of vatSys should be directed to the VATNZ Training Team. The GitHub Issue Tracker is for feature requests and bugs concerning the NZ Dataset itself. + +When submitting an issue, there's a few guidelines that we request you follow. + +* **Search the Issue Tracker** before you submit an issue, as it may already be present. [The Issue Tracker can be found here](https://github.com/vatSys/new-zealand-dataset/issues). + +* When opening an issue, please provide as much information as you can to ensure that others are able to act upon the requests or bug report. If you are raising an issue for a bug you have encountered, you should also include how to replicate the bug. + +### Pull Requests + +We welcome pull requests with fixes and improvements to the NZ Dataset. The features that are free and not assigned to somebody will be marked as "up-for-grabs" in the Issue Tracker, but other improvements are also welcome - please ensure you follow the pull work-flow below. This work-flow is designed to be simple, but also ensure consistency from **all** members. + +1. Fork the project. + +2. Commit your changes to your forked Repo. + +3. **Add your changes to the CHANGELOG.md file**. This can be found in [NEW-ZEALAND-DATASET/.github/CHANGELOG.md](CHANGELOG.md). + +4. Push the commit(s) to your fork. + +5. Submit a Pull Request (PR) to the master Repo. **See below for PR formatting rules**. + +6. Be prepared to answer any questions about your PR when it is reviewed for acceptance. + +#### Pull Request Guidelines + +* The PR title should describe the change that has been made. + +* The PR description should confirm what changes have been made and how you know they're correct (through testing). + +* Include any relevant screenshots to prove the changes work. + +* Ensure you link any relevant issues in the merge request, remembering that you can link to the issue using a hash and the issue ID, eg #22. + +* When you've submitted a PR, comment on the Issue referencing the pull request in the same method as before, eg #pr-id. + diff --git a/Profile.xml b/Profile.xml index c32297d..019c873 100644 --- a/Profile.xml +++ b/Profile.xml @@ -1,6 +1,6 @@ - + diff --git a/README.md b/README.md index 8ed8683..55aa973 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # VATNZ vatSys Dataset Project +[![Currently Released AIRAC](https://img.shields.io/badge/Currently%20Released%20AIRAC-2014A-blue)](https://github.com/vatnz-dev/new-zealand-dataset) + The VATNZ vatSys Dataset project is an open source collaborative project allowing members of the VATNZ community to work together to create a high-quality dataset to use in vatSys. A new sector file will be released in line with each AIRAC cycle (as long as significant changes warrant such as release).