feat: Flat import of markdown repo

This is a flat (without history) import of (some of) the content
from our markdown module.

We've imported this without history because the repo contains our
blog posts and showcases posts content prior to porting them to strapi.

Since this contains many images, it would balloon the size of this repo
to import the full history.

Instead, please refer to the history of the (archived) markdown repo
at: https://github.com/freesewing/markdown

markdown/dev/howtos/code/adding-snippets/en.md

@@ -0,0 +1,30 @@
+---
+title: Adding snippets
+for: developers
+about: Shows you how to add snippets to your pattern
+---
+
+After using the [shorthand](/howtos/core/shorthand/) call, 
+`Snippet` contains the path constructor, while `snippets` is a reference to `part.snippets`,
+which is where you should store your paths.
+
+Things will now *just work* when you do this:
+
+```js
+snippets.logo = new Snippet('logo', points.logoAnchor);
+```
+
+You can scale and rotate a snippet by setting the `data-scale` and `data-rotate` attributes respectively.
+
+ - **data-scale** : Either a single scale factor, or a set of 2 scale factors for the X and Y axis respectively. See [the SVG scale transform](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/transform#Scale) for details.
+ - **data-rotate**: A rotation in degrees. The center of the rotation will be the snippet's anchor point
+
+<Tip>
+
+See [Using attributes](/howtos/core/attributes/) for details on how to set attributes.
+
+</Tip>
+
+Below is an example of the available snippets, and the use of the `data-scale` and `data-rotate` attributes:
+
+<Example pattern="rendertest" caption="Overview of available snippets" options={{ colors: false, text: false, macros: false, circles: false, widthHd: false }} />