Skip to content

JSON:API spec experiment#145

Closed
Sporiff wants to merge 21 commits into
mainfrom
json-api-spec-experiment
Closed

JSON:API spec experiment#145
Sporiff wants to merge 21 commits into
mainfrom
json-api-spec-experiment

Conversation

@Sporiff

@Sporiff Sporiff commented Aug 27, 2025

Copy link
Copy Markdown
Member

🚨 EXPERIMENT ONLY 🚨

This PR is just a brain dump of some things I've been thinking about regarding a structured and linked approach to designing the API. Nothing in this PR is agreed-upon with the team. This PR exists only to generate a preview link.

Overview

This PR is the culmination of many different thoughts I've had about the Open Podcast API, its future, and how we can try to unstick the project. It takes the existing ideas already present and rearranges them in the following ways:

  1. Using JSON:API as a standard format for linked endpoint data.
  2. Using the new UUIDv5 logic proposed in Add UUID namespace details #140.

Starlight changes

This PR also brings some changes to clean up the appearance of Starlight. This is just an experiment to see how well this would work for our use case. These changes can easily be ported.

@Sporiff Sporiff self-assigned this Aug 27, 2025
@netlify

netlify Bot commented Aug 27, 2025

Copy link
Copy Markdown

Deploy Preview for openpodcastapi ready!

Name Link
🔨 Latest commit 8da4a57
🔍 Latest deploy log https://app.netlify.com/projects/openpodcastapi/deploys/68e690a15472580008acf607
😎 Deploy Preview https://deploy-preview-145--openpodcastapi.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@Sporiff

Sporiff commented Jan 8, 2026

Copy link
Copy Markdown
Member Author

Not going to use this, but will probably take some of the ideas for rearranging the docs.

@Sporiff Sporiff closed this Jan 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant