Skip to content

Docs: Blog plugin is enabled with RSS and Atom feeds but the site has no blog #208

Description

@mallison031

Repo context. accensa-app is the off-chain half of Accensa — the merchant back-office for x402 sellers on Stellar. This issue concerns apps/docs, the Docusaurus 3.10 documentation site published to https://accensa.github.io/accensa-app/. It documents all three Accensa repositories, so a defect here is the first thing a new integrator sees.

🟢 Unblocked. Small configuration cleanup; decide the intent first.

Problem

apps/docs/docusaurus.config.ts configures the blog preset in detail:

blog: {
  showReadingTime: true,
  feedOptions: { type: ['rss', 'atom'], xslt: true },
  editUrl: 'https://github.com/accensa/accensa-app/tree/main/apps/docs/',
  onInlineTags: 'warn',
  onInlineAuthors: 'warn',
  onUntruncatedBlogPosts: 'warn',
},

There is no apps/docs/blog/ directory. The plugin is fully configured for a blog that does not exist — so the build generates empty RSS and Atom feeds, and a /blog route with no content.

Empty feeds are the real cost: they are discoverable, and a reader who subscribes gets a feed that will never deliver anything, with no indication it was never intended to.

What to build

Decide whether Accensa wants a blog, then make the config say so.

  1. If no blog is planned: disable the preset (blog: false) and confirm the /blog route and both feeds disappear from the build output.
  2. If a blog is planned: keep the configuration and add a first post, so the feeds are not empty. Do not leave it configured-but-absent, which is the current state and the actual problem.
  3. Check the navbar and footer for links to /blog either way.

Ask in the community channels before choosing — this is a product question, not a technical one, and guessing wrong means the work is reverted.

Out of scope: writing blog content beyond a single placeholder post, if that path is chosen.

Acceptance criteria

  • The config reflects a deliberate decision, stated in the PR.
  • If disabled, no /blog route and no feed files appear in apps/docs/build.
  • If kept, the feeds contain at least one entry.
  • No navigation element links to a route that does not exist.
  • pnpm build succeeds for apps/docs (onBrokenLinks is set to throw, so a broken link fails the build).
  • pnpm typecheck passes in apps/docs.
  • PR description includes Closes #<this issue>.

Contact & Support

Metadata

Metadata

Assignees

Labels

Stellar WaveDrips Wave Programarea: docsWork in docscomplexity: trivial100 pts — small, clearly bounded, obvious acceptance criteriadocumentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions