OpenFn / OpenFn/apollo

Add public API documentation

Open
#465 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Jupyter Notebook
Stars
5
Forks
10
Avg merge
2d 20h
Merged PRs (30d)
17

Description

API reference per service

Maybe as swagger specs?

Ideally with basic unit tests against those specs (perhaps mocking out the model calls)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files or tests are named. Start by mapping the services and their public API entry points, then determine whether OpenAPI or Swagger specs are the intended format. Define the required reference coverage and basic mocked model-call checks so completion is verifiable.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
api, documentation, testing-qa
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.