Sunshine: Document the API using OpenAPI
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 25/100
- Issue type
- Documentation
- Clarity
- Needs clarification
- Activity status
- Stale
- Tech stack
- cpp, openapi
- Domain
- api, documentation
Research direction
Start by reviewing the existing work in PR #3540 for the Sunshine API and the issue's concern about generating OpenAPI documentation for C++. Determine the documentation scope and how the API should be represented without an automatic generator. Done means the API is documented using OpenAPI and the resulting documentation is complete enough to replace the current approach.
Written by the indexing model from the issue text.
Description
Is there an existing issue for this item?
- I have searched the existing issues
Repositories
LizardByte/Sunshine
Languages/Skills/Technologies
Documentation, C++
Description
OpenAPI is the standard way to document APIs, let's try to move to that.
A PR has been started for this work although it is quite overwhelming as there is no auto generator for C++ (at least when using Simple-Web-Server). https://github.com/LizardByte/Sunshine/pull/3540
Estimated Effort
effort:Large
Priority
priority:Medium
Target Milestone
3-6 months
Dependencies
No response
- Dominant language
- No language data
- Stars
- 2
- Forks
- 0
- Avg merge
- 21m
- Merged PRs (30d)
- 7
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from LizardByte/roadmap
-
1-3 months C++ effort:Large LizardByte/libvirtualhid LizardByte/Sunshine planned priority:High
LizardByte/roadmap#183 · 1 assignee ·
-
1-3 months C++ effort:Extra-Large LizardByte/Sunshine planned priority:Medium
Difficulty 4/5 Over a week Newbie friendliness 30/100
LizardByte/roadmap#181 · 1 comment · 6 reactions ·
-
1-3 months effort:Large LizardByte/Sunshine packaging planned priority:Medium
Difficulty 5/5 Over a week Newbie friendliness 35/100
LizardByte/roadmap#178 ·
-
1-3 months C++ CSS effort:Medium HTML JavaScript LizardByte/Sunshine planned priority:High Vue
Difficulty 5/5 Over a week Newbie friendliness 35/100
LizardByte/roadmap#153 · 2 reactions ·
-
Dependency Dashboard Opendependencies
LizardByte/roadmap#151 · 1 assignee ·
All issues in LizardByte/roadmap
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
mksglu/context-mode#1200 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
clawsweeper:needs-maintainer-review clawsweeper:needs-product-decision clawsweeper:no-new-fix-pr impact:auth-provider issue-rating: 🌊 off-meta tidepool P2
Difficulty 1/5 Under an hour Newbie friendliness 80/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100