Skip to content

Commit 024c31b

Browse files
authored
improvement(changelog): refresh media and released product updates (#8866)
* improvement(changelog): open recordings in the shared lightbox * improvement(changelog): refresh product captures and released updates * improvement(changelog): write concise product announcements * docs(changelog): align the editorial body limit
1 parent ba485c6 commit 024c31b

17 files changed

Lines changed: 297 additions & 65 deletions

File tree

Lines changed: 44 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
import { cn } from '@sim/emcn'
1+
import { cn, Lightbox } from '@sim/emcn'
22
import { isChangelogMediaSource } from '@/lib/changelog/media'
33
import { LANDING_STAGE_RADIUS } from '@/app/(landing)/components/landing-layout'
44

@@ -8,31 +8,58 @@ interface ChangelogVideoProps {
88
/** Accessible description for the player; not repeated below the video. */
99
caption: string
1010
captionsSrc?: string
11+
width?: number | `${number}`
12+
height?: number | `${number}`
1113
}
1214

13-
/** Product recordings load on demand and retain a readable description without playback. */
14-
export function ChangelogVideo({ src, poster, caption, captionsSrc }: ChangelogVideoProps) {
15+
/** A quiet poster opens the recording in the shared media viewer. */
16+
export function ChangelogVideo({
17+
src,
18+
poster,
19+
caption,
20+
captionsSrc,
21+
width = 1280,
22+
height = 720,
23+
}: ChangelogVideoProps) {
1524
if (!isChangelogMediaSource(src) || (captionsSrc && !isChangelogMediaSource(captionsSrc))) {
1625
throw new Error('Changelog recordings must use same-origin paths or the approved media CDN')
1726
}
1827
return (
1928
<figure className='my-6'>
20-
<video
21-
controls
22-
muted={!captionsSrc}
23-
playsInline
24-
crossOrigin='anonymous'
25-
preload='none'
29+
<Lightbox
30+
type='video'
31+
src={src}
2632
poster={poster}
27-
aria-label={caption}
28-
className={cn('aspect-video w-full bg-[var(--surface-2)]', LANDING_STAGE_RADIUS)}
33+
alt={caption}
34+
captionsSrc={captionsSrc}
35+
crossOrigin='anonymous'
2936
>
30-
<source src={src} type='video/mp4' />
31-
{captionsSrc ? (
32-
<track kind='captions' src={captionsSrc} srcLang='en' label='English' default />
33-
) : null}
34-
<a href={src}>Watch the demo</a>
35-
</video>
37+
<button
38+
type='button'
39+
aria-label={`Open ${caption} in media viewer`}
40+
className={cn(
41+
'block w-full cursor-zoom-in overflow-hidden focus-visible:outline focus-visible:outline-2 focus-visible:outline-[var(--text-primary)] focus-visible:outline-offset-4',
42+
LANDING_STAGE_RADIUS
43+
)}
44+
>
45+
<video
46+
muted
47+
playsInline
48+
preload='none'
49+
poster={poster}
50+
width={width}
51+
height={height}
52+
aria-hidden='true'
53+
tabIndex={-1}
54+
className='pointer-events-none block h-auto w-full bg-[var(--surface-2)]'
55+
>
56+
<source src={src} type='video/mp4' />
57+
{captionsSrc ? (
58+
<track kind='captions' src={captionsSrc} srcLang='en' label='English' />
59+
) : null}
60+
</video>
61+
</button>
62+
</Lightbox>
3663
</figure>
3764
)
3865
}

‎apps/sim/content/changelog/README.md‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Choose a few relevant links instead of repeating every destination in a separate
5050

5151
## Search and answer-engine visibility
5252

53-
Keep each summary independently useful: name Sim and the feature, explain the new capability, and state material availability limits in the article. Put setup steps and demonstration explanations in server-rendered text alongside the media. Do not leave important facts only inside a screenshot or video.
53+
Keep each summary independently useful: name Sim and the feature, explain the new capability, and state material availability limits in the article. Write a short announcement of what changed and why it is useful, with a contextual setup link. Keep capture notes and review evidence in the production brief, out of public prose and media descriptions. Do not leave important facts only inside a screenshot or video.
5454

5555
The index and archive use real links, semantic lists, and CollectionPage/ItemList data matching the visible entries. Articles keep their own canonical URLs, BlogPosting data, authorship metadata, original publication dates, and substantive correction dates. Public articles appear in the sitemap and RSS; previews stay noindex and drafts stay out of public routes. Preserve these properties when changing the layout. If the archive eventually needs pagination, use server-rendered pages with real next/previous links and a self-canonical URL for each page; do not make older entries accessible only through a JavaScript button.
5656

@@ -61,11 +61,11 @@ After deployment, verify a representative article and the archive with Search Co
6161
## Artifact delivery
6262

6363
- Record one complete action and its visible result with sample data in a dedicated demo workspace. Verify the feature and permissions in that environment first. Use the product's normal theme and typography. Keep the cursor and text readable; crop around the relevant controls while preserving enough context to understand the action.
64-
- Export an H.264 MP4 at a readable resolution, usually 1280×720 or 1920×1080. Keep it about 20–45 seconds and optimize it for web playback with `+faststart`. Prefer a focused demonstration with native playback controls over a decorative loop. Check the final crop on a 390px-wide screen.
65-
- Take screenshots and the poster from the reviewed product capture. Choose a frame that shows the announced result, with a legible 16:9 crop for the story card. A separate 1200×630 share image can use the same frame with enough safe area for cropping. Keep the headline and benefit in the page's HTML rather than baking them into the image. Compress local JPEG, WebP, or PNG assets and retain actual screenshot dimensions in MDX.
64+
- Export an H.264 MP4 at a readable resolution, usually 1280×720 or 1920×1080. Keep it about 20–45 seconds and optimize it for web playback with `+faststart`. The article shows the reviewed poster; playback starts only after opening the shared lightbox, which provides pause, seeking, and zoom controls. Spoken recordings include captions and an unmute control. Check the preview and expanded recording on a 390px-wide screen.
65+
- Take screenshots and the poster from the reviewed product capture. Choose a frame that shows the announced result. Preserve the capture's aspect ratio and provide its actual width and height in MDX for both screenshots and videos. A separate 1200×630 share image can use the same frame with enough safe area for cropping. Keep the headline and benefit in the page's HTML rather than baking them into the image. Compress local JPEG, WebP, or PNG assets.
6666
- Use immutable, versioned media filenames, such as `compare-workflow-deployments-v1.mp4`. Upload recordings and spoken captions under `changelog/` in the existing public Academy asset store: `https://nnjgp7vypgx4myuq.public.blob.vercel-storage.com`. Put the returned public URLs in the entry. The app CSP and content audit explicitly allow this origin for recordings and captions. Small optimized walkthroughs under 1 MiB can live in `public/changelog/` and deploy atomically with their entry. Use the CDN for larger recordings. The component does not upload or proxy videos.
6767
- Serve MP4s as `video/mp4` and spoken captions as `text/vtt`. The existing CDN supports HTTP Range requests, cross-origin playback, and caching. Use a new filename for every revision and verify those response headers on the uploaded asset. Do not overwrite an existing recording URL.
68-
- In the deployment preview, check playback, seeking, captions, poster loading, and mobile readability. A silent recording uses the component's muted default. Spoken recordings need a WebVTT file.
68+
- In the deployment preview, check opening and closing the lightbox, playback, pause, seeking, zoom, captions, poster loading, and mobile readability. Recordings start muted; spoken recordings need a WebVTT file and expose an unmute control.
6969
- Generate social and email drafts from the reviewed product story: capability, practical benefit, and one link to the canonical entry. Use the same claims and restrictions everywhere. Keep distribution manual until the format and review process are established.
7070

7171
AI can prepare storyboards, copy, captions, and clearly labeled conceptual diagrams. Screenshots and feature recordings must come from the real product. Do not generate fictional controls, results, performance numbers, or before-and-after evidence. Label a walkthrough assembled from still captures as a step-by-step walkthrough; do not describe it as a continuous recording. Keep its UI frames unmodified and record the assembly method in the production brief.
@@ -101,6 +101,8 @@ release:
101101
<ChangelogVideo
102102
src="https://nnjgp7vypgx4myuq.public.blob.vercel-storage.com/changelog/demo-v1.mp4"
103103
poster="/changelog/your-update-poster.jpg"
104+
width="1280"
105+
height="720"
104106
caption="Describe the action and result shown in the demo."
105107
captionsSrc="https://nnjgp7vypgx4myuq.public.blob.vercel-storage.com/changelog/demo-v1.vtt"
106108
/>

‎apps/sim/content/changelog/compare-workflow-deployments/index.mdx‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@ slug: compare-workflow-deployments
33
title: 'Compare workflow versions before you deploy'
44
description: 'See prompt edits, added steps, and changed connections in Sim. Compare two deployments or check your draft against the live workflow.'
55
date: '2026-10-02T06:55:11Z'
6+
updated: '2026-10-10T01:48:00Z'
67
authors: [waleed]
78
tags: [Workflows]
8-
ogImage: /changelog/compare-workflow-deployments-v1.jpg
9+
ogImage: /changelog/compare-workflow-deployments-v2.jpg
910
ogAlt: 'Sim compares two workflow versions, highlighting a prompt edit and an added Slack step'
1011
technical: false
1112
draft: false
@@ -14,14 +15,13 @@ release:
1415
url: https://github.com/simstudioai/sim/releases/tag/v0.9.10
1516
---
1617

17-
<ChangelogVideo
18-
src="/changelog/compare-workflow-deployments-v1.mp4"
19-
poster="/changelog/compare-workflow-deployments-v1.jpg"
20-
caption="Review a prompt edit and an added Slack step. Edited walkthrough from real Sim captures with sample data."
18+
<ChangelogImage
19+
src="/changelog/compare-workflow-deployments-v2.jpg"
20+
alt="Workflow comparison highlighting a changed agent prompt and an added Slack step"
21+
width="1200"
22+
height="605"
2123
/>
2224

23-
Open deployment history and choose **Compare** from a version's menu. Select a changed block to inspect its settings alongside the workflow. For a draft, choose **View changes** to compare it with the live version before redeploying.
25+
Compare any two workflow deployments, or review your draft against the live version. See prompt edits, added steps, and changed connections together so you can check exactly what will change before deploying.
2426

25-
Use it to review a support agent's new instructions and the [Slack](/integrations/slack) step added to send its digest. The comparison is read-only and leaves your draft intact.
26-
27-
Included in **v0.9.10**. See the [deployment guide](https://docs.sim.ai/workflows/deployment) for setup, or [compare versions through the API](https://docs.sim.ai/api-reference/workflows/compareWorkflowVersionsV2).
27+
Open **Compare** in deployment history or **View changes** on your draft. [Learn more about deployments](https://docs.sim.ai/workflows/deployment).

‎apps/sim/content/changelog/compare-workflow-deployments/production.md‎

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Deployment comparison: production record
22

3-
Status: prepared for publication review. Only `index.mdx` is rendered publicly.
3+
Status: published; October 9 media refresh prepared for review. Only `index.mdx` is rendered publicly.
44

55
## Evidence
66

@@ -11,21 +11,17 @@ Status: prepared for publication review. Only `index.mdx` is rendered publicly.
1111

1212
## Media provenance
1313

14-
A dedicated local workspace contains a synthetic support-ticket workflow with two deployments. The second changes the agent prompt and adds a Slack step. No model or Slack call was executed for this capture.
14+
Refreshed on October 9, 2026 (October 10 UTC), using the running local app at commit `36f91a76e2`, including the current embedded comparison presentation from #8862. A dedicated disposable workspace contains a synthetic support-ticket workflow with two deployment snapshots. The second changes the agent prompt and adds a Slack step. No model or Slack call was executed.
1515

16-
The media comes from the running product, captured through the browser. The video is a silent, edited walkthrough assembled from three unmodified UI captures with reading pauses; it is not a continuous screen recording. No generated controls or results are used.
16+
Open deployment history, choose Compare from v2's menu, and inspect v1 against v2. The reviewed image shows the real comparison dialog, including the changed prompt, added Slack step, and connection. It is a direct browser capture cropped to the dialog, 1200 × 605 pixels; no controls or results were generated or altered.
1717

18-
1. Open deployment history.
19-
2. Open the version menu and choose Compare.
20-
3. Inspect the changed prompt, added Slack step, and connection.
21-
22-
Assets: `/changelog/compare-workflow-deployments-v1.mp4` and `/changelog/compare-workflow-deployments-v1.jpg`. The poster is the final comparison view. The short MP4 is served locally with the site; larger future recordings should use the approved media CDN. Keep filenames immutable.
18+
Current asset: `/changelog/compare-workflow-deployments-v2.jpg`. A still is more useful for inspecting this before/after state than the previous slideshow. It opens in the shared image lightbox and supplies the share image. The earlier v1 JPEG and MP4 remain available at their immutable URLs for existing links, but the article no longer embeds the video.
2319

2420
## Review notes
2521

26-
The screenshot replaces the older deployment-history reference. The comparison is read-only and shows actual before/after fields. Copy covers both two-version comparison and draft-versus-live review; the media demonstrates the two-version path. The draft remains unchanged after opening and closing Compare.
22+
The refreshed screenshot replaces the edited video walkthrough. The comparison is read-only and shows actual before/after fields. Copy covers both two-version comparison and draft-versus-live review; the media demonstrates the two-version path. The draft remains unchanged after opening and closing Compare.
2723

28-
The entry keeps the historical release timestamp and RSS identity. Playback, mobile layout, asset responses, and content validation belong in the publication PR's validation record. Assign the release editor and feature reviewer in that PR; verify the public URL before distributing.
24+
The entry keeps the historical release timestamp and RSS identity. Lightbox zoom, mobile layout, asset responses, and content validation belong in the publication PR's validation record. Assign the release editor and feature reviewer in that PR; verify the public URL before distributing.
2925

3026
## Announcement drafts
3127

‎apps/sim/content/changelog/editorial-standard.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ Keep existing article URLs, original dates, and RSS identities when refining his
1414

1515
- Headline: name the capability or action, at most 65 characters. Avoid generic headlines such as “A better experience.”
1616
- Summary: 15–40 words for search, sharing, and RSS, naming Sim and explaining the capability in plain language. It must make sense without the image.
17-
- Body: normally 60–180 words, with one concrete example or short path to the feature. Explain the action and result; do not repeat the summary or turn a small improvement into a tutorial.
18-
- Media: place the reviewed image or video immediately after the article header, before procedural detail. Images use the shared lightbox and can show a brief caption for a necessary demonstration limit. Videos keep native playback controls and an accessible description, without a repeated description beneath the player. Any material claim limitation belongs in the article's prose.
17+
- Body: lead with what changed and what teams can do with it. Aim for 2–4 short sentences, usually 30–90 words, followed by a useful documentation link. There is no minimum word count; keep the body under 120 words. Use one concrete example when it adds clarity. Save setup instructions for the linked guide; do not pad a simple update into a tutorial.
18+
- Media: place the reviewed image or video immediately after the article header. Both use the shared lightbox; videos show a plain poster with playback, seeking, and zoom controls inside the viewer. Use concise alt text or an accessible action label without a visible video description. Do not add captions or prose about how the capture was made, whether a query ran, sample credentials, or what a screenshot does not prove. Keep capture provenance and review evidence in production.md.
1919
- Supporting notes: up to three related, source-backed improvements, each one sentence. Omit empty sections. Do not invent extras to fill a template.
2020
- Links: one descriptive setup/documentation link, plus an integration, model, or product link when directly relevant. Use the actual catalog slug and guide. Put links in context; avoid a wall of generic “Learn more” links.
21-
- Availability: retain real version, plan, permission, and rollout restrictions in the article. Keep unverified rollout questions, source analysis, capture instructions, and approval checkboxes in production.md.
21+
- Availability: keep restrictions that affect whether someone can use the feature, such as a required plan or administrator role, in one concise sentence. Link to documentation for setup details. Keep unverified rollout questions, source analysis, capture instructions, and approval checkboxes in production.md. Never substitute a capture disclaimer for verifying a claim.
2222

2323
Use short active sentences and familiar words. Technical identifiers, retry timings, queue keys, PR numbers, and performance claims without measurements do not belong in the article. There is no minimum number of announcements per week.
2424

@@ -36,7 +36,7 @@ Every production brief records:
3636

3737
Use the same clean demo workspace and product theme. Frame the relevant panel with enough context to locate it, and make the result legible at a 390px viewport. Hide unrelated private sidebar content before recording. Keep UI text and controls intact; never generate a different product state to improve a screenshot. Prefer recording at the intended framing over aggressive crops later.
3838

39-
Begin with the task ready to perform, show the action, and hold on its result. Avoid decorative intros, music, title cards, and excessive cursor movement. Keep the headline and important explanation in HTML. Label videos assembled from still screenshots as edited walkthroughs.
39+
Begin with the task ready to perform, show the action, and hold on its result. Avoid decorative intros, music, title cards, and excessive cursor movement. Keep the headline and important explanation in HTML. Record videos assembled from still screenshots as edited walkthroughs in the production brief; do not describe them as continuous recordings in public copy.
4040

4141
Choose the poster deliberately after reviewing the video. An opening menu, empty state, spinner, or arbitrary first second rarely explains the feature. The media workflow can provide candidate frames, but an editor selects the final timestamp. Preview candidates are not approved assets. Preserve the real aspect ratio inside the shared media frame; do not stretch product UI. Use the same reviewed result frame for the article poster and share image when it works in both contexts.
4242

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
slug: intune-device-inventory
3+
title: 'Bring Intune device inventory into your agents'
4+
description: 'Use Microsoft Intune in Sim to read managed devices, installed application inventory, and compliance status for IT reviews and agent follow-ups.'
5+
date: '2026-10-08T07:10:06Z'
6+
authors: [waleed]
7+
tags: [Integrations]
8+
ogImage: /changelog/intune-device-filter-v1.jpg
9+
ogAlt: 'Microsoft Intune block in Sim configured to list noncompliant devices'
10+
technical: false
11+
draft: false
12+
release:
13+
versions: [v0.9.15]
14+
---
15+
16+
<ChangelogImage
17+
src="/changelog/intune-device-filter-v1.jpg"
18+
alt="Microsoft Intune List Devices operation with a noncompliant-device filter in Sim"
19+
width="1280"
20+
height="720"
21+
/>
22+
23+
Your agents can now read managed devices, installed applications, and compliance status from [Microsoft Intune](/integrations/microsoft-intune). Filter for noncompliant devices to prepare an IT review or bring device inventory into an agent's response.
24+
25+
[Connect Microsoft Intune](https://docs.sim.ai/integrations/intune) to get started. An active Intune license, appropriate account role, and administrator consent are required.

0 commit comments

Comments
 (0)