diff --git a/README.md b/README.md index 12a060d..d4e64fd 100644 --- a/README.md +++ b/README.md @@ -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).* - -![ZA_Cape waypoints](img/ZA.jpg "ZA_Cape waypoints") - ---- -### :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" - ---- -![XCSoar screenshot](img/XCSoar.jpg "XCSoar screenshot") +#### Please head over to the Cape Gliding Club's official fork of this repository for waypoint releases and contributions: https://github.com/cgcza/waypointsZA