Merge branch 'main' into davidkpiano/v5-cheatsheet

Author: davidkpiano

blog/2020-05-27-state-management-bad-bolean-good-boolean/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: "State Management: How to tell a bad boolean from a good boolean"
+title: "How to tell a bad boolean from a good boolean"
 description: "TL;DR: Bad booleans represent state. Good booleans are derived from state"
 tags: [tutorial]
 authors: [matt]

blog/2021-12-14-what-are-the-biggest-benefits-youve-had-from-using-state-machines/index.mdx

@@ -1,8 +1,7 @@
 ---
-title: What are the biggest benefits you’ve had from using state machines?
-description: >-
-  At Stately we’re fans of state machines, but we wanted to ask our
-  community… what are the benefits that you’ve experienced from using state machines?
+title: What are the biggest benefits of state machines?
+description: 'At Stately we’re fans of state machines, but we wanted to ask our
+  community… what are the benefits you’ve experienced from using state machines?'
 tags: [weekly question, community, state machine]
 authors: [laura]
 image: /blog/2021-12-14-what-are-the-biggest-benefits-youve-had-from-using-state-machines.png

blog/2022-03-11-xstate-vscode-extension-now-available-on-the-open-vsx-registry/index.mdx

@@ -1,9 +1,7 @@
 ---
-title: XState VSCode extension now available on the Open VSX Registry
-description: >-
-  If you use VSCodium, Coder, Gitpod or another editor with VSCode-compatible
-  extensions, you can now install the XState VSCode extension from the Open VSX
-  Registry.
+title: Open VSX XState VSCode extension now available
+description: 'If you use VSCodium, Coder, Gitpod or another editor with VSCode-compatible
+  extensions, you can now install the XState VSCode extension.'
 tags: [extension, open source, xstate, vscode]
 authors: [laura]
 slug: /2022/03/11/xstate-vscode-extension-now-available-on-the-open-vsx-registry

blog/2022-06-13-nesting-typegen-files/index.mdx

@@ -1,11 +1,11 @@
 ---
-title: "Nesting XState typegen files"
+title: 'Nesting XState typegen files'
 description: What is file nesting in VS Code and how to enable it for XState's generated type files.
 tags: [stately, extension, open source, xstate, vscode]
 authors: [anders]
 image: /blog/2022-06-13-nesting-typegen-files.png
-slug: 2022-06-13-nesting-typegen-files
-date:  2022-06-13
+slug: nesting-typegen-files
+date: 2022-06-13
 ---
 
 Our latest update to the [XState VS Code extension](https://marketplace.visualstudio.com/items?itemName=statelyai.stately-vscode) has made it easy to enable file nesting for typegen files. But what is file nesting?

blog/2022-07-06-whats-new-july-2022/index.mdx

@@ -1,11 +1,11 @@
 ---
-title: "What’s new in July 2022?"
+title: 'What’s new in July 2022?'
 description: Search for machines, pinch to zoom, nest typegen files and more! Find out the latest features in the Stately editor and XState VS Code extension.
 tags: [stately, xstate, announcement, editor, search, typegen, survey, roadmap]
 authors: [laura]
 image: /blog/2022-07-06-whats-new-july-2022.png
 slug: 2022-07-06-whats-new-july-2022
-date:  2022-07-06
+date: 2022-07-06
 ---
 
 On top of our usual minor improvements and bug fixes, we’ve got great new features to share with you in July!
@@ -28,7 +28,7 @@ Trackpad fans rejoice; you can now pinch to zoom in and out to navigate the edit
 
 ## Nesting typegen files
 
-You’re missing out if you’re not using [our XState VS Code extension](https://marketplace.visualstudio.com/items?itemName=statelyai.stately-vscode) yet! After a top tip from our friend Erik Rasmussen, Anders added the feature to our VS Code extension. Read [Anders’ blog post on nesting XState typegen files](/blog/2022-06-13-nesting-typegen-files/index.mdx) for more details.
+You’re missing out if you’re not using [our XState VS Code extension](https://marketplace.visualstudio.com/items?itemName=statelyai.stately-vscode) yet! After a top tip from our friend Erik Rasmussen, Anders added the feature to our VS Code extension. Read [Anders’ blog post on nesting XState typegen files](/blog/nesting-typegen-files) for more details.
 
 ## Labels on quick action buttons
 
@@ -38,7 +38,7 @@ The quick action buttons for adding states and guarded transitions are now label
 
 ## More upcoming features
 
-We’ve got many more features coming up. Watch [our office hours from last week](https://www.youtube.com/watch?v=4v_M3HcZc3U) and [office hours from June 24](https://www.youtube.com/watch?v=qmbeYvcA3Ks) for demos of [smoother transition lines](https://www.youtube.com/watch?v=qmbeYvcA3Ks&t=530s), [fit to content on initial render](https://www.youtube.com/watch?v=4v_M3HcZc3U&t=1214s) and [parity between XState and the Stately editor](https://www.youtube.com/watch?v=4v_M3HcZc3U&t=208s). 
+We’ve got many more features coming up. Watch [our office hours from last week](https://www.youtube.com/watch?v=4v_M3HcZc3U) and [office hours from June 24](https://www.youtube.com/watch?v=qmbeYvcA3Ks) for demos of [smoother transition lines](https://www.youtube.com/watch?v=qmbeYvcA3Ks&t=530s), [fit to content on initial render](https://www.youtube.com/watch?v=4v_M3HcZc3U&t=1214s) and [parity between XState and the Stately editor](https://www.youtube.com/watch?v=4v_M3HcZc3U&t=208s).
 
 ## Suggest features and help us prioritize our roadmap
 
@@ -60,4 +60,4 @@ Matt has made five great videos for [our YouTube channel](https://www.youtube.co
 
 ## Please give us feedback in our yearly survey
 
-And finally, [the Stately 2022 survey](https://stately.ai/survey) is out, and we would love you to add your response to help us make our tools work for you. All the questions are optional, and it will take just five minutes of your time.
+And finally, [the Stately 2022 survey](https://stately.ai/survey) is out, and we would love you to add your response to help us make our tools work for you. All the questions are optional, and it will take just five minutes of your time.

blog/2022-11-22-studio-update/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: 'New in the Studio: Safari support, new login providers, and more!'
+title: 'New: Safari support, new login providers, and more!'
 description: It’s been just over a month since we released Stately Studio 1.0, and the team has barely slowed down! We’ve got more features live in the Studio today and even more planned before the end of the year.
 tags: [editor, studio, safari, login, performance]
 authors: [laura]

blog/2022-11-29-import-from-code/index.mdx

@@ -34,7 +34,7 @@ And please import your code into an existing machine with caution! Importing cod
 
 ## Export code
 
-What about exporting your machines as code? You might have missed this feature as we released it as part of the [Stately Studio 1.0 release](https://stately.ai/blog/introducing-stately-studio-10#more-export-options). You can export your machine as JSON, JavaScript, and TypeScript using the code panel in the right tool menu. 
+What about exporting your machines as code? You might have missed this feature as we released it as part of the [Stately Studio 1.0 release](https://stately.ai/blog/2022-10-18-introducing-stately-studio-1-0#more-export-options). You can export your machine as JSON, JavaScript, and TypeScript using the code panel in the right tool menu. 
 
 Using the export icon button in the editor’s top bar, you can also export as code from the **Export machine** dialog. [Check out Laura’s demo utilizing this feature to go from modeling your machine to code](https://www.youtube.com/watch?v=NVQai9SBpiU).
 

blog/2023-01-20-whats-new-in-2023/index.mdx

@@ -17,7 +17,7 @@ Happy 2023! The Stately team is back from their [first off-site of the year in L
 
 ## Import from code
 
-[Import from code](https://stately.ai/blog/new-in-the-studio-import-from-code) was one of our most-requested features from users who had already created machines using XState or our Stately Viz. You can import an existing machine from JavaScript, TypeScript or JSON using the code panel in the editor’s right tool menu or the Machines list in the left drawer. Import from code works well with our existing export as code feature, where you can export your machine as JSON, JavaScript, and TypeScript using the code panel in the right tool menu.
+[Import from code](https://stately.ai/blog/2022-11-29-import-from-code) was one of our most-requested features from users who had already created machines using XState or our Stately Viz. You can import an existing machine from JavaScript, TypeScript or JSON using the code panel in the editor’s right tool menu or the Machines list in the left drawer. Import from code works well with our existing export as code feature, where you can export your machine as JSON, JavaScript, and TypeScript using the code panel in the right tool menu.
 
 ![Code panel open in the Studio with the Import button highlighted.](2022-11-29-import-from-code-right-panel.png)
 

blog/2023-04-21-embed-url/index.mdx

@@ -0,0 +1,17 @@
+---
+title: Embed URL
+description: '🤫 We’re testing a new feature where you can embed machines.'
+authors: [laura]
+tags: [changelog, new, beta]
+date: 2023-04-21
+slug: 2023-04-21-embed-url
+image: /blog/2023-07-18-embed-url.png
+---
+
+🤫 We’re testing a new feature where you can embed machines.
+
+From the **Share** menu, there’s now a **Copy embed URL** button. You can use this URL in an `<iframe>` to embed your machine anywhere `<iframe>`s are allowed. We love to use embedded machines in our docs!
+
+![embed-url](https://canny.io/images/d1135e463827ba77d2199971d2e7d1e9.png)
+
+We plan to add more to this feature in the future, and [we’d love to hear your feedback](https://discord.gg/xstate).

blog/2023-04-28-new-default-machine/index.mdx

@@ -0,0 +1,21 @@
+---
+title: 'New default machine'
+description: 'There’s now a more detailed default machine when you create a new machine in Stately Studio or jump straight into modeling at state.new.'
+authors: [laura]
+tags: [changelog, improved]
+date: 2023-04-28
+slug: 2023-04-28-new-default-machine
+image: /blog/2023-04-28-new-default-machine.png
+---
+
+There’s now a more detailed default machine when you create a new machine in Stately Studio or when you jump straight into modeling at state.new.
+
+<!--truncate-->
+
+![Stately Studio machine featuring initial state, guards, parent and child states, and using descriptions.](https://canny.io/images/362e27b65f13dfe7ce6979a91a5fdd6c.png)
+
+We hope this will help you get started and maybe learn more about features you’ve not used before.
+
+If you don’t want any of these states and transitions in your new machine, you can drag to select all the unwanted features and hit backspace to delete them.
+
+We’d love your thoughts about our new default machine; please [give us your feedback in our Discord!](https://discord.gg/xstate)