This repository has been archived by the owner on Nov 10, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
1 addition
and
88 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,89 +1,2 @@ | ||
| ### Waypoints for glider pilots flying in the Cape, South Africa. | ||
|
|
||
| A note on naming: | ||
| *Although pilots usually talk of* "turnpoints", *this project uses the more general term* | ||
| "waypoints" (**WP**) *to explicitly include Starting Points, Finishing Points, Reporting Points, | ||
| Airfields, etc. and the actual Turn Points. This is defined in Sporting Code for Gliding (SC3).* | ||
|
|
||
|  | ||
|
|
||
| --- | ||
| ### :south_africa: To Fly with the waypoints :south_africa: | ||
| To use the WP file on your glide computer (that supports CUP files): | ||
|
|
||
| 1. Download or copy the latest released [`ZA_Cape_yyyy-mm-dd.cup`](../../releases/latest) | ||
| CUP file (under Releases' "Assets") to the correct location on your device. | ||
| 2. Activate it. | ||
| 3. Fly. | ||
|
|
||
| --- | ||
| ### Goals | ||
| 1. [One](https://xkcd.com/927/), [single point of truth](https://en.wikipedia.org/wiki/Single_source_of_truth) | ||
| for waypoints, including unique names, unique three character shortcodes (trigraphs), | ||
| unique locations, and normalised descriptions. | ||
| 2. Version controlled, with full history (who did what, when, and why). | ||
| 3. Open source, open data, including all history and versions. | ||
| 4. **Anybody** can contribute (and anybody can fork). | ||
| 5. Automatically incorporated into glide computers that support downloading (e.g. | ||
| [XCSoar](https://github.com/XCSoar/xcsoar-data-content/tree/master/waypoints-special)) | ||
|
|
||
| ### To View the WPs | ||
| 1. [WaypointsZA](https://docs.google.com/spreadsheets/d/13YJ6NrfoLhxTgeO8fi1aIT0n_nm4z0_ixXWjndgwzjE/edit#gid=364570956) master spreadsheet. | ||
| *(Please help us resolve the 🔺red🔺 CGC comments therein.)* | ||
| 2. Generated, current HEAD [GeoJSON map](https://gist.github.com/csindle/736c3658c29ba2a29abffdc2917e1839). | ||
| 3. Generated, current HEAD [searchable](https://gist.github.com/csindle/86d782cc0405dd54a80eecc3838ffe83) CSV file. | ||
| 4. Generated, released [Google map](https://www.google.com/maps/d/u/0/edit?mid=1OdQ9Jp9IcUgXAMa7qQpaBRQReOhAuitc&usp=sharing). | ||
|
|
||
| ### To Contribute and Maintain the WPs | ||
| *We explicitly welcome contributions, comments, requests, and suggestions.* | ||
|
|
||
| Please see [`CONTRIBUTING.md`](CONTRIBUTING.md) for the details. | ||
|
|
||
| --- | ||
| ### Precedents | ||
| The BGA have been honing their WPs (and the management policies thereof) since 1988. | ||
| In lieu of our own policies and procedures, please use theirs for guidance: | ||
|
|
||
| 1. [Policy](http://www.newportpeace.co.uk/turningpoints.htm) | ||
|
|
||
| Arizona gliding community WP documentation (who also use the modern git version control system): | ||
|
|
||
| 1. [Instructions for updating and editing](https://docs.google.com/presentation/d/1pMjyXVpgSP-2waq6FuD5_nyMrU_6ApVSMYG6YpMSBvM/edit?usp=sharing) | ||
| 1. [Map](https://www.google.com/maps/d/u/0/edit?mid=1kHawbgbNa_hPMl5rvOVMP27UdMX1PvQ_&ll=32.39213804431958%2C-111.49211784793266&z=11) | ||
| 1. [Waypoint repository](https://github.com/DavisChappins/AZTurnpoints). | ||
|
|
||
| --- | ||
| ### Out-landings | ||
| *(Up for debate: please make your voice heard!)* | ||
|
|
||
| We are attempting to keep a list of out-landing (OL) fields in | ||
| [`ZA_Cape_Outlandings.cup`](ZA_Cape_Outlandings.cup). | ||
|
|
||
| Rules for inclusion: | ||
|
|
||
| 1. **Special:** I.e. we are not going to include every successful out-landing in the vast fields of Porterville. | ||
| 2. **Useful:** A permanent field reachable from Robertson Spur is very useful. Or ones along any popular route. | ||
| 3. **Surveyed:** By in-person inspection, previous out-landing, cross-country training, etc. | ||
|
|
||
| It is a separate file containing only *landables* (style: "3 Outlanding"), with a low hurdle for accepting | ||
| contributions. | ||
|
|
||
| Please contribute, so that we can improve safety and help introduce new pilots to cross-country flying. | ||
|
|
||
| --- | ||
| ### Definitions | ||
| *(Up for debate: please make your voice heard!)* | ||
|
|
||
| In a WP **name** field, the following suffixes are defined: | ||
|
|
||
| 1. **#** (hash): Air Activity, caution. E.g. Para-gliding launch site (source BGA). | ||
| 2. **911**: Emergency only. Landing area may be too narrow or otherwise unsuitable (source Arizona). | ||
| 3. **U**: Unsurveyed. A ground inspection has not been done; data from satellite only (source Arizona). | ||
| 4. **X**: Emphasize that a non-landable (e.g. waypoint, bridge, etc.) is indeed, not landable, even if it looks like | ||
| an airstrip from the air. | ||
|
|
||
| Multiple suffixes can be combined (space separated): e.g. "Buffelsport 911 U" | ||
|
|
||
| --- | ||
|  | ||
|
|
||
| #### Please head over to the Cape Gliding Club's official fork of this repository for waypoint releases and contributions: https://github.com/cgcza/waypointsZA |