@@ -3,29 +3,52 @@ title: "Docs From Conversation: Transcript → Docs Workflow"
33description : " How to turn a livestream transcript into public documentation using tags and automation."
44fragmentId : " ec40ee5d-1e24-472c-8ea2-b105fc1bb60b"
55fragmentType : " Knowledge"
6- createdBy : " b3843e12-2dcb-4402-abd5-563bad4ce5f3 "
7- createdAt : " 2025-10-21T15:24:43.110Z "
8- updatedAt : " 2025-10-21T15:24:43.110Z "
9- badges : ["new" ]
6+ createdBy : " unknown "
7+ createdAt : " 2025-10-30T12:27:21.573Z "
8+ updatedAt : " 2025-10-22T13:38:11.213Z "
9+ badges : []
1010---
1111
12- ### Overview
13- This guide shows how to turn a livestream transcript (e.g., “Usable 101”) into public docs using the Usable Docs Fragment Template.
14-
15- ### Steps
16- 1 ) Capture the transcript into a fragment (Transcripts/Recipe)
17- 2 ) Draft new docs as independent fragments
18- 3 ) Add template tags for publishing:
19- - ` status:published `
20- - ` repo:usable-docs `
21- - ` category:guides ` (plus ` subcategory:docs ` if needed)
22- 4 ) Save to trigger the migration pipeline
23-
24- ### Tips
25- - Keep each doc focused on a single concept
26- - Use clear titles, short summaries, and descriptive tags
27- - Optionally set ` slug: ` and ` order: ` tags
28-
29- ### References
30- - Usable Docs Fragment Template
31- - Usable 101 Transcript
12+ # Docs From Conversation: Transcript → Docs Workflow
13+
14+ > Category: Guides | Difficulty: Beginner | Last Updated: 2025-10-21
15+
16+ ## Overview
17+ Turn livestream transcripts (e.g., “Usable 101”) into public documentation using the webhook‑ready template.
18+
19+ ### What You'll Learn
20+ - Draft docs from a transcript
21+ - Tag fragments for auto‑publishing
22+ - Trigger the migration pipeline
23+
24+ ### Prerequisites
25+ - Usable account and a transcript fragment
26+
27+ ### Estimated Time
28+ ⏱️ 8 minutes
29+
30+ ## Tutorial / How-To
31+
32+ ### Step 1: Capture Transcript
33+ Create a Transcript or Recipe fragment with the full transcription.
34+
35+ ### Step 2: Draft Individual Docs
36+ Create new fragments for each focused topic.
37+
38+ ### Step 3: Add Publishing Tags
39+ Add ` status:published ` , ` repo:usable-docs ` , and ` category: ` /` subcategory: ` tags.
40+
41+ ### Step 4: Save
42+ Saving triggers the migration pipeline.
43+
44+ ## Best Practices
45+ - One concept per document
46+ - Clear titles, short summaries, descriptive tags
47+ - Optionally use ` slug: ` and ` order: ` for fine control
48+
49+ ## Related Resources
50+ - Usable Public Documentation Template - Webhook-Ready Structure (dc983960-2482-45a8-b604-0ae770797226)
51+ - Usable 101 - Complete Tutorial Transcript
52+
53+ ---
54+ ** Footer Note:** This documentation is part of the Usable Public workspace and is automatically synced to the docs site.
0 commit comments