Merge pull request #461 from radiantearth/dev

Merge dev to master for 0.7.0 release

.circleci/config.yml

@@ -1,29 +1,18 @@
 version: 2
 jobs:
   build:
+    working_directory: ~/stac
     docker:
       - image: circleci/python:3.6.4
 
-    working_directory: ~/stac
-
     steps:
       - checkout
       - run: sudo chown -R circleci:circleci /usr/local/bin
       - run: sudo chown -R circleci:circleci /usr/local/lib/python3.6/site-packages
-      - restore_cache:
-          key: v2-python-requirements-{{ checksum "requirements.txt" }}
       - run:
           name: install
           command: |
-            git clone git@github.com:sparkgeo/stac-validator.git ~/stac-validator
-            cd ~/stac-validator
-            pip install -r requirements.txt
-            pip install .
-      - save_cache:
-          key: v2-python-requirements-{{ checksum "requirements.txt" }}
-          paths:
-            - "~/.cache/pip"
-            - "/usr/local/lib/python3.6/site-packages"
+            pip install stac-validator
       - run:
           name: validate
           command: |

CHANGELOG.md

@@ -4,6 +4,37 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## Unreleased
+
+None yet.
+
+## [v0.7.0] - 2019-05-06
+
+### Fixed
+- Updated language / fixed typos
+- Moved static vs dynamic discussion text to catalog best practices document
+- Moved hosting of interactive api docs from swaggerhub to [stacspec.org](http://stacspec.org)
+- JSON Schemas are now all following the latest JSON Schema version, draft 07.
+
+### Changed
+- No longer require an absolute self link for Items, Collections and Catalogs.
+- Reorganized api-spec, added extensions folder to hold API extensions
+- Change the fields parameter in the API to allow filtering on any property.
+- Refinements to SAR extension, changed several fields from a single array-based field (`sar:absolute_orbit`, `sar:resolution`, `sar:pixel_spacing`, `sar:looks`) to multiple fields with exactly one value.
+- Commons extension ability to 'merge' properties is now in the core specification
+
+### Added
+- Catalog best practices document, including recommendations for catalog layouts, html, and self-contained catalogs.
+- `page` parameter for STAC API
+- Optional `collection` property field in Items (previously part of the Commons extension)
+- It is now required to link to `/stac/search/` from `/stac/`
+- Added new fields to SAR extension: `sar:incidence_angle`, `sar:relative_orbit`, `sar:observation_direction`
+- Added new filter parameters `ids` and `collections` to `/stac/search/`
+
+### Removed
+- Removed the field `sar:off_nadir` from the SAR extension
+- JavaScript-based validation
+
 ## [v0.6.2] - 2019-03-01
 
 ### Fixed
@@ -130,6 +161,7 @@ Thanks @hgs-msmith, @matthewhanson, @hgs-trutherford, @rouault, @joshfix, @alkam
 
 
 [Unreleased]: https://github.com/radiantearth/stac-spec/compare/master...dev
+[v0.7.0]: https://github.com/radiantearth/stac-spec/compare/v0.6.2...v0.7.0
 [v0.6.2]: https://github.com/radiantearth/stac-spec/compare/v0.6.1...v0.6.2
 [v0.6.1]: https://github.com/radiantearth/stac-spec/compare/v0.6.0...v0.6.1
 [v0.6.0]: https://github.com/radiantearth/stac-spec/compare/v0.5.2...v0.6.0

README.md

@@ -29,7 +29,7 @@ The minimal amount is specified right now, but best practices should emerge with
 ## Current version and branches
 
 The [master branch](https://github.com/radiantearth/stac-spec/tree/master) is the 'stable' version of the spec. It is currently version 
-**0.6.2** of the specification. The 
+**0.7.0** of the specification. The 
 [dev](https://github.com/radiantearth/stac-spec/tree/dev) branch is where active development takes place, and may have inconsistent examples. 
 Whenever dev stabilizes a release is cut and we merge dev in to master. So master should be stable at any given time.
 It is possible that there may be small releases in quick succession, especially if they are nice improvements that do 
@@ -108,7 +108,7 @@ Vendors can extend those core fields for the metadata they want to make availabl
 
 #### UML Diagram
 
-A UML diagram of the [STAC model](STAC-060-uml.pdf) is provided to help with navigating the specification. 
+A UML diagram of the [STAC model](STAC-UML.pdf) is provided to help with navigating the specification. 
 
 ## Contributing
 

STAC-UML.drawio

@@ -0,0 +1 @@
+<mxfile modified="2019-05-02T22:15:20.207Z" host="www.draw.io" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36" etag="X3IN4gN4FBmbly-o-h6u" version="10.6.6" type="device"><diagram id="TgNYBds_Jc586sA2aelI" name="STAC 0.7.0">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</diagram></mxfile>