Skip to content

add screen recording and video guidance to changelog post guide#4830

Open
sumitshinde-84 wants to merge 6 commits intomainfrom
sumitshinde-84-patch-13
Open

add screen recording and video guidance to changelog post guide#4830
sumitshinde-84 wants to merge 6 commits intomainfrom
sumitshinde-84-patch-13

Conversation

@sumitshinde-84
Copy link
Copy Markdown
Contributor

Adds guidance on how to include screen recordings and videos in changelog posts.

  • Documents the recommended video embed approach using the <lite-youtube> component
  • Clarifies the DevRel upload process and unlisted vs public publishing
  • Adds GIF guidance with size and quality requirements

Description

Related Issue(s)

Checklist

  • I have read the contribution guidelines
  • I have considered the performance impact of these changes
  • Suitable unit/system level tests have been added and they pass
  • Documentation has been updated
  • For blog PRs, an Art Request has been created (instructions)

Adds guidance on how to include screen recordings and videos in changelog posts.

- Documents the recommended video embed approach using the `<lite-youtube>` component
- Clarifies the DevRel upload process and unlisted vs public publishing
- Adds GIF guidance with size and quality requirements
@sumitshinde-84 sumitshinde-84 requested review from allthedoll and removed request for ZJvandeWeg April 8, 2026 11:55
@sumitshinde-84
Copy link
Copy Markdown
Contributor Author

@allthedoll Could you please review this PR?

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 8, 2026

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit 2dcadc0
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/69d6423bf080070008f618d9
😎 Deploy Preview https://deploy-preview-4830--flowforge-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 88 (🟢 up 1 from production)
Accessibility: 81 (no change from production)
Best Practices: 100 (no change from production)
SEO: 91 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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


**Videos** are the recommended way to show screen recordings. To add one:

1. Ask DevRel to upload the recording to YouTube. Give them the video title and they will handle the upload. By default it will be published as **unlisted**. If the recording is polished and has voiceover and refined editing, let them know it may be worth publishing publicly.
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.

Who DevRel is or how/where to reach them is unclear. Maybe we say to ask in dept-marketing?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done, Updated

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 8, 2026

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit e91977d
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/69d65ac4f7f8480008b8f396
😎 Deploy Preview https://deploy-preview-4830--flowforge-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 85 (🔴 down 2 from production)
Accessibility: 81 (no change from production)
Best Practices: 100 (no change from production)
SEO: 91 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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


**Videos** are the recommended way to show screen recordings. To add one:

1. Ask in [#dev-marketing](https://flowfuse.slack.com/archives/C02TG4WH5PC) to have the recording uploaded to YouTube. Give them the video title and they will handle the upload. By default it will be published as **unlisted**. If the recording is polished and has voiceover and refined editing, let them know it may be worth publishing publicly.
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.

should we better define what "polished" means? or say something like if your video is approved by devrel?


- `YOUR_VIDEO_ID` with the video ID from the YouTube URL
- `Your Video Title` with a short descriptive title for the video

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.

should we enable closed captions on the youtube video for accessibility?

Copy link
Copy Markdown
Contributor

@allthedoll allthedoll left a comment

Choose a reason for hiding this comment

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

lgtm just added a couple more thoughts

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.

2 participants