Skip to content

docs(media): enable autodocs pages for the media stack stories#328

Merged
garrity-miepub merged 8 commits into
mieweb:mainfrom
jlocala1:docs/media-autodocs
Jul 24, 2026
Merged

docs(media): enable autodocs pages for the media stack stories#328
garrity-miepub merged 8 commits into
mieweb:mainfrom
jlocala1:docs/media-autodocs

Conversation

@jlocala1

Copy link
Copy Markdown
Collaborator

Switches on the generated Docs pages for the media stack — MediaEditor, the MediaEditor Live Demo, and TranscriptView all carry docs.description text but lacked the autodocs tag (157 story files in the repo have it; MediaPlayer already does), so their Docs pages were never generated. Also adds the missing ScriptPanel sentence to the Live demo's description.

3 files, +7/−1. pnpm format verified locally; no component code touched.

MediaEditor, the MediaEditor Live Demo, and TranscriptView all carry
docs.description text but lacked the autodocs tag (157 story files in
the repo have it; MediaPlayer already does), so no Docs page was ever
generated for them. Also mention the ScriptPanel in the Live Demo
description — it was absent.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 23, 2026 16:39

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Enables Storybook-generated Docs pages for the media stack stories by adding the autodocs tag to story meta definitions, and updates the MediaEditor Live Demo’s docs description to include the missing ScriptPanel sentence.

Changes:

  • Added tags: ['autodocs'] to TranscriptView, MediaEditor, and MediaEditor Live Demo story metadata so Docs pages are generated.
  • Extended the MediaEditor Live Demo docs.description.component text to mention the ScriptPanel behavior.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
src/components/TranscriptView/TranscriptView.stories.tsx Adds autodocs tag so Storybook generates the Docs page for TranscriptView.
src/components/MediaEditor/MediaEditorLive.stories.tsx Adds autodocs tag and expands Docs description with ScriptPanel details.
src/components/MediaEditor/MediaEditor.stories.tsx Adds autodocs tag so Storybook generates the Docs page for MediaEditor.

Copilot AI review requested due to automatic review settings July 23, 2026 18:17

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comment thread src/components/MediaEditor/MediaEditorLive.stories.tsx Outdated
Copilot AI review requested due to automatic review settings July 23, 2026 20:34

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Copilot AI review requested due to automatic review settings July 23, 2026 21:37

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

With autodocs enabled, the Live Demo meta was the only autodocs-tagged
story under src/components without a `component` (157/157 others have
one), so its generated docs page had nothing to document. The demo
already imports and renders MediaEditor - declare it.

Found by Copilot review on mieweb#328.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 23, 2026 21:42

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

src/components/MediaEditor/MediaEditorLive.stories.tsx:26

  • meta is typed as Meta without a component generic, but this story now sets component: MediaEditor. In this codebase, stories that provide component consistently use Meta<typeof Component> to ensure type safety (e.g. src/components/MediaPlayer/MediaPlayer.stories.tsx:13-16, src/components/ErrorPage/ErrorPage.stories.tsx:9-12). Leaving the generic off can cause TypeScript to treat component as ComponentType<Args> and reject MediaEditor’s props type.
const meta: Meta = {
  title: 'Components/Images & Media/MediaEditor Live Demo',
  component: MediaEditor,
  tags: ['autodocs'],

Copilot AI review requested due to automatic review settings July 24, 2026 01:26

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comment thread src/components/MediaEditor/MediaEditorLive.stories.tsx Outdated
The story renders the LiveDemo harness, not <MediaEditor {...args}/>, so
the Controls panel autodocs derives from MediaEditor's props would not
drive anything. MediaEditor's own autodocs page keeps the interactive
props table. Also types the meta as Meta<typeof MediaEditor> to match
the other story files.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 24, 2026 17:50

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Copilot AI review requested due to automatic review settings July 24, 2026 17:52

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

@garrity-miepub
garrity-miepub self-requested a review July 24, 2026 18:33

@garrity-miepub garrity-miepub left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! Fills in the last three media components missing autodocs.

@garrity-miepub
garrity-miepub merged commit 1da8d6b into mieweb:main Jul 24, 2026
8 checks passed
garrity-miepub pushed a commit that referenced this pull request Jul 24, 2026
With autodocs enabled, the Live Demo meta was the only autodocs-tagged
story under src/components without a `component` (157/157 others have
one), so its generated docs page had nothing to document. The demo
already imports and renders MediaEditor - declare it.

Found by Copilot review on #328.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

3 participants