Skip to content

docs: condense README and add documentation links (follow-up to #51)#52

Merged
adurrr merged 1 commit into
mainfrom
chore/update-readme-docs
Jun 11, 2026
Merged

docs: condense README and add documentation links (follow-up to #51)#52
adurrr merged 1 commit into
mainfrom
chore/update-readme-docs

Conversation

@adurrr

@adurrr adurrr commented Jun 11, 2026

Copy link
Copy Markdown
Owner

Summary

Follow-up to #51. The README was 570 lines and duplicated the full documentation now available in the example site. This PR condenses it to a focused ~170-line gateway.

What changed

Removed (duplicate content now in docs):

  • Detailed installation steps and comparison table
  • Footer player setup instructions
  • Site-wide configuration reference
  • Full shortcode parameters table
  • Source adapters documentation (AzuraCast, iVoox)
  • Navigation persistence internals
  • Podcast RSS feed configuration
  • CSS theming tables and ::part() reference
  • Keyboard shortcuts table
  • Events API reference
  • Troubleshooting section

Added:

  • Prominent Live demo and Documentation links at the top
  • Documentation table linking to all 8 docs pages with descriptions
  • Spanish docs mention (/es/docs/)

Kept (unique README value):

  • Badges, demo GIF, intro
  • How It Works table
  • Features bullet list
  • Minimal Quick Start (one shortcode + footer HTML)
  • Condensed Installation (2 concise options)
  • Development section (project structure, test suites, source adapters)
  • License

Replace the 570-line README (which duplicated the docs section content)
with a focused 170-line gateway that:

- Keeps the intro, badges, GIF, How It Works, and Features sections
- Adds prominent links to the live demo and documentation
- Condenses Quick Start to a minimal working example with links
- Replaces detailed reference sections (installation, shortcode params,
  source adapters, persistence, RSS, CSS theming, events, keyboard
  shortcuts, troubleshooting) with a Documentation table linking to
  each docs page
- Keeps the Development section (project structure, test suites, source
  adapter guide) which is unique README content
- Updates the demo GIF alt text to reflect new docs and language features

The README now serves as a landing page that funnels users to the
comprehensive in-theme documentation at exampleSite/content/docs/.
@adurrr adurrr merged commit 75ca6fd into main Jun 11, 2026
4 checks passed
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