Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Write draft OpenAPI spec for repository API #18

Open
erickpeirson opened this issue Jun 27, 2019 · 0 comments
Open

Write draft OpenAPI spec for repository API #18

erickpeirson opened this issue Jun 27, 2019 · 0 comments
Labels
good first issue Good for newcomers repository service Work related to the canonical repository service

Comments

@erickpeirson
Copy link
Contributor

Here is an intro to how we use OpenAPI: https://arxiv.github.io/arxiv-arxitecture/crosscutting/services.html#schema

This should live at repository/schema/OpenAPI.yaml.

The spec should match our implementation of #17 . One or the other can happen first. We'll revise it as we implement use-cases, e.g. to add examples and references to JSON Schema for individual resources.

@erickpeirson erickpeirson added good first issue Good for newcomers repository service Work related to the canonical repository service labels Jun 27, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers repository service Work related to the canonical repository service
Projects
None yet
Development

No branches or pull requests

1 participant