sillsdev / sillsdev/languageforge-lexbox

verification test openapi schema for lexbox public api

Open
#1,315 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

📦 Lexbox
Dominant language
C#
Stars
9
Forks
8
Avg merge
2d 13h
Merged PRs (30d)
49

Description

Describe the feature
We don't want our api surface area to change without us knowing either on purpose or accidentally. A good way to handle that would be with a verification test (examples in DataModelSnapshotTests) of our openapi schema. I'm not quite sure how to get the schema in a test but I don't think it should be difficult.

Contributor guide

No contributing guide indexed for this repository

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

Start by examining the DataModelSnapshotTests examples and the existing OpenAPI schema generation used by the public API. Determine how the schema can be obtained in a test, then add verification coverage that detects unintended schema changes and confirms the expected schema remains stable.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp, openapi
Domain
api, testing
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.