Building Markdoc: A Powerful, Flexible Open Source Markdown Framework
Offered By: All Things Open via YouTube
Course Description
Overview
Explore the development and impact of Markdoc, an open-source Markdown framework, in this conference talk from All Things Open 2022. Discover the history behind Stripe's creation of Markdoc for their documentation site, its significance in building Stripe's extensive content platform, and the decision to make it open source. Learn about the framework's core concepts, including nodes, tags, attributes, variables, and custom functions. Gain insights into the OSS community's adoption of Markdoc and witness demonstrations of its integration with various web frameworks. Delve into Stripe's background, the evolution of their documentation from 2012 to 2022, and the lessons learned that led to this new approach. Understand the goals behind Markdoc's development and how it compares to traditional Markdown. Get an overview of the Markdoc development site and GitHub repository, and learn how this powerful tool can enhance your documentation workflow.
Syllabus
Introduction
Mike BiFulco
Open Source
APIs You Wont Hate
Gymnastic
MikeBiFulco
Newsletter
Stripe Dev
Stripe Background
Stripe History
Stripe Docs 2012
Stripecom 2022
Stripes Products
Languages
Payments
Code Samples
Dynamic Content
Documentation Pages
Ruby on Rails
Lessons Learned
New Approach
Goals
What is Markdown
What Markdown looked like
What is Markduck
Who created Markduck
Markduck blog post
What is Markdoc
Core Concepts
Nodes
Tags
Attributes
Variables
Functions
Custom Functions
Validation
Rendering
Markdown Dev Site
Github
Repo
Good to each other
Taught by
All Things Open
Related Courses
User Experience for the WebOpen2Study Writing READMEs
Udacity Introduction to Research
Indian Institute of Technology Madras via Swayam Technical Writing
Moscow Institute of Physics and Technology via Coursera Research Writing
Indian Institute of Technology, Kharagpur via Swayam