Repository navigation
Docs: Bridge 2c-2a podcast episodes on disk - #157
Merged
Merged
Conversation
Describe Phase 2c-2a storage APIs, policies, pinned generations and recovery; include the podcast library setup screenshot.
# Conflicts: # docs-developers/server/api/index.md # docs-developers/server/data-model.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs for Bridge Phase 2c-2a (podcast episodes on disk).
User Guide: admin/podcasts.md covers retention per show (Keep N / On demand / Archive, default Keep 3 and 7 days after every follower finished, set by an admin through the API with curl examples), what protects an episode, "Keep N is a window, not a disk limit", the episode size cap (
podcasts.max_episode_mb/AUDIOSILO_BRIDGE_PODCASTS_MAX_EPISODE_MB), and hard links with the no-replace rename fallback. It also embeds a new screenshot of the add-library dialog with Kind = Podcasts. There are touch-ups in libraries.md, bridge.md, server.md and running-a-bridge.md. Released player apps still don't show podcasts, and absent episodes stay 404 until 2c-2b.Developer docs: bridge/podcasts.md (fetch and retain jobs, the aggregate retention check, feed.json
fetch, generations and the strong ETag, the publication journal), attachments.md (CHAPchapters.json,from: id3_chap), configuration, mappings, pairing-and-jobs, the server API reference and index, data model (0054), scanner, modules, auth-and-security, configuration and the cross-repo contract.Screenshots:
library-add-podcasts.png(new; manifest and capture step added),libraries.png,library-add.pngandlibrary-edit.pngrefreshed from the real console build.Verification: npm run build and typecheck are green, and every claim was checked against server 40e76eb and Bridge a792c40. Reviewed with /simplify, then /code-review high --fix. main (F1 docs) is merged in.
Pairs with KodeStar/audiosilo-server#163 and KodeStar/audiosilo-bridge#8.