Skip to content
This repository was archived by the owner on Oct 28, 2022. It is now read-only.

Commit cf2bc1b

Browse files
committed
Merge pull request #511 from macieksmuga/0.6-release-notes-2
Release notes edits. Follow-on to PR #449.
2 parents 4628a2f + 6c60c95 commit cf2bc1b

File tree

1 file changed

+46
-46
lines changed

1 file changed

+46
-46
lines changed

doc/release-notes.md

+46-46
Original file line numberDiff line numberDiff line change
@@ -1,79 +1,79 @@
11
# Changes to `ga4gh/schemas` `master` branch since version `v0.5.1` (Oct 2, 2014)
22

3-
### Pervasive changes
3+
## Pervasive changes
44

55
Renamed all protocols and records to remove the "`GA`" prefix from
66
their names. (Hence `GASearchVariantSetsRequest` is now
7-
`SearchVariantSetsRequest`, etc.) The exception is `GAException`,
8-
which is unchanged.
7+
`SearchVariantSetsRequest`, etc.)
8+
The exception is `GAException`, which is unchanged.
99

1010
There is no longer one unitary namespace. Objects now reside in
1111
"`org.ga4gh.models`", methods in "`org.ga4gh.methods`".
1212

13-
Updated the version number to `0.6.0-SNAPSHOT`.
13+
Updated the version number to `0.6.0a1`.
1414

15-
### Added
1615

17-
Datasets are now used throughout the API.
16+
## Changes visible to API clients
1817

19-
#### Methods:
18+
### Additions
2019

21-
* `getDataset`
22-
* `searchDatasets`
23-
* `getReadGroupSet`
24-
* `getReadGroup`
25-
* `getVariant`
26-
* `getVariantSet`
27-
* `getCallSet`
20+
`Dataset` is now utilized throughout the API.
2821

29-
#### Records:
22+
#### New methods, HTTP endpoints:
3023

31-
* `ExternalIdentifier`
32-
* `Experiment`
33-
* `Dataset`
34-
* `ReadStats`
35-
* `Fragment` _(apparently unused)_
24+
* `getDataset` via GET `datasets/<id>`
25+
* `searchDatasets` via POST `/datasets/search`
26+
* `getReadGroupSet` via GET `/readgroupsets/<id>`
27+
* `getReadGroup` via GET `/readgroups/<id>`
28+
* `getVariant` via GET `/variants/<id>`
29+
* `getVariantSet` via GET `/variantsets/<id>`
30+
* `getCallSet` via GET `/callsets/<id>`
3631

37-
#### Enum:
32+
#### New and modified entities:
3833

39-
* `Strand`
40-
41-
### Removed
42-
43-
* `src/main/resources/avro/beacon.avdl`
44-
* Files designated "Work In Progress" ("`wip`"):
45-
* `src/main/resources/avro/wip/metadata.avdl`
46-
* `src/main/resources/avro/wip/metadatamethods.avdl`
47-
* `src/main/resources/avro/wip/variationReference.avdl`
48-
49-
### Changed
50-
51-
Moved `GAException` to `methods.avdl`.
34+
* New record type `ExternalIdentifier` introduced.
35+
* New record type `ReadStats` now optionally part of a returned `ReadGroup` or `ReadGroupSet` object.
36+
* `Position` record type now specifies strand via new enum `Strand` (in place of `boolean reverseStrand`).
5237

5338
#### Field default values:
5439

55-
* `SearchReadsRequest.start` is optional and no longer defaults to 0.
56-
* Boolean fields in `ReadAlignment` now default to `null` instead of `false`.
40+
* `SearchReadsRequest.start` as passed into `/reads/search` is optional and no longer defaults to 0.
41+
* Boolean fields in `ReadAlignment` as returned from `/reads/search` now default to `null` instead of `false`.
5742

5843
#### Field types:
5944

60-
* `SearchVariantSetsRequest` now takes a single dataset ID, not an array.
61-
* `SearchCallSetsRequest` now takes a single variant set ID, not an array.
62-
* `SearchReferenceSetsRequest` changed two parameters from arrays to
45+
* `SearchVariantSetsRequest` as passed into `/variantsets/search` now takes a single dataset ID, not an array.
46+
* `SearchCallSetsRequest` as passed into `/callsets/search` now takes a single variant set ID, not an array.
47+
* `SearchReferenceSetsRequest` as passed into `/referencesets/search` changed two parameters from arrays to
6348
singletons:
6449

6550
* `md5checksum`
6651
* `accession`
6752

6853
#### New fields:
6954

70-
* `SearchReferencesRequest` now accepts a `referenceSetId` parameter.
71-
* `SearchVariantsRequest` now takes a `variantSetId` parameter.
72-
* `SearchReadsRequest` now includes `readGroupIds`.
73-
* `SearchReadGroupSetsRequest` takes a `datasetId`.
74-
* `ReferenceSet` now includes a name.
75-
* `VariantSet` adds name and reference set ID fields.
76-
* `ReadGroup` adds `stats`.
55+
* `SearchReferencesRequest` passed into `/references/search` now accepts a `referenceSetId` parameter.
56+
* `SearchVariantsRequest` passed into `/variants/search` now takes a `variantSetId` parameter.
57+
* `SearchReadsRequest` passed into `/reads/search` now includes `readGroupIds`.
58+
* `SearchReadGroupSetsRequest` passed into `/readgroupsets/search` takes a `datasetId`.
59+
* `ReferenceSet` returned from `/references/search` now includes a name.
60+
* `VariantSet` returned from `/variants/search` adds name and reference set ID fields.
61+
* `ReadGroup` returned from `/readgroups/<id>` adds `stats`.
62+
63+
64+
## Changes internal to Schemas, documentation and organization
65+
66+
### Removed
67+
68+
* `src/main/resources/avro/beacon.avdl`
69+
* Files designated "Work In Progress" ("`wip`"):
70+
* `src/main/resources/avro/wip/metadata.avdl`
71+
* `src/main/resources/avro/wip/metadatamethods.avdl`
72+
* `src/main/resources/avro/wip/variationReference.avdl`
73+
74+
### Changed
75+
76+
Moved `GAException` to `methods.avdl`.
7777

7878
## Documentation
7979

0 commit comments

Comments
 (0)