James Eddy

Add ReadTheDocs for user/developer documentation

6

See https://data-object-service.readthedocs.io/en/latest/ for an example (related DRS issue here: https://github.com/ga4gh/data-repository-service-schemas/issues/56).

Create frozen version of v1 Swagger spec and add equivalent OpenAPI spec

2

Based on #134, the idea would be to create a folder `/openapi/v1/`, which would include: + `workflow_execution_service.swagger.yaml` + `workflow_execution_service.openapi.yaml` The `swagger.yaml` file would be the OpenAPI 2.0 version currently published...

Create JSON Schema spec from Swagger model definitions during docs build

1

See #135 for the origin of this ticket. Idea (from @susheel) is "to allow a non-swagger client to still validate the JSON response without processing the swagger spec to extract...

Bump to OpenAPI 3.0

7

With major substantive and structural changes happening to the spec en route to v1.0, I wonder if now would also be the best time to bite the bullet and convert...

Improve `service-info` to enable service discovery

3

The Discovery Networks team is developing a specification to register and discover API services (e.g., across GA4GH); see slides from 2018-12-10 Cloud Work Stream call for background: https://docs.google.com/presentation/d/1-TFvBdIYaxm-MpR7WBL8U5eqHa2Po2DuDyu7HBfjVyY/edit We should...

Add a `workflow_params_drs_headers` field to `RunWorkflow` endpoint

2

[Notes](https://docs.google.com/document/d/1XsYCMG2JkJen-ZjPAcy7c9RfA41wbzAmXBkB3iQm6PI/edit?usp=sharing) from GA4GH Connect Implementation meeting in Hinxton (April 2019): > - it’s an array of {, } pairs > - WES is expected, whenever fetching a DRS URI, to...

Clean up `service-info` based on AMED feedback

2

Branching this out as a separate issue from #122. > They did some cleanup work on `/service-info` and want to see what others think. Here is there service-info > >...

More granular `supported_filesystem_protocols` in service info

4

Currently this is just an array: ```yaml supported_filesystem_protocols: type: array items: type: string description: |- The filesystem protocols supported by this service, currently these may include common protocols such as...

The `additionalProperties` tag in Swagger2.0 allows one to specify types for the **values** in an object, assuming that the **keys** can be arbitrary strings. For example, a model for a...

Incorrect exit code / status for CWL run with Toil backend

1

When running the `md5sum.cwl` workflow using Toil, the job seems to hang indefinitely in "RUNNING" state. Looking at the run log, the workflow appears to have completed successfully, but the...