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/reference/config/dependencies/en.md

@@ -0,0 +1,19 @@
+---
+title: dependencies
+---
+
+```js
+dependencies: {
+  front: "back",
+  sleeveplacket: ["sleeve", "cuff"]
+}
+```
+
+An object of `key`-`value` pairs that controls the order in which pattern parts will get drafted.
+
+<Tip>
+
+See [Part dependencies](/advanced/dependencies) for more in-depth information on dependencies.
+
+</Tip>
+

markdown/dev/reference/config/en.md

@@ -0,0 +1,28 @@
+---
+title: Pattern configuration file
+for: developers
+about: Reference documentation for the pattern configuration file
+---
+
+```js
+import { version } from '../package.json'
+
+export default {
+  version,
+  name: "sorcha",
+  // More configuration here
+}
+```
+
+A pattern configuration file exports a default object with the following properties:
+
+<ReadMore list />
+
+<Note>
+
+This is about the pattern configuration file, used at build-time.
+
+For run-time configuration, see [Pattern settings](/reference/settings/).
+
+</Note>
+

markdown/dev/reference/config/hide/en.md

@@ -0,0 +1,15 @@
+---
+title: hide
+---
+
+```js
+hide: [
+  "base"
+]
+```
+
+An array that lists pattern parts that should be hidden by default.
+
+Hidden means that they will be drafted, but not rendered. Typically used
+for a base part on which other parts are built.
+

markdown/dev/reference/config/inject/en.md

@@ -0,0 +1,20 @@
+---
+title: inject
+---
+
+```js
+inject: {
+  front: "back"
+}
+```
+
+An object of key/value pairs of parts. The `value` part will be injected in the `key` part.
+
+By *injected* we mean rather than starting out with a fresh part, you'll get a part that
+has the points, paths, and snippets of the `value` part.
+
+<Tip>
+
+See [the Howto on Part inheritance](/howtos/core/inject) for an example.
+
+</Tip>

markdown/dev/reference/config/measurements/en.md

@@ -0,0 +1,22 @@
+---
+title: measurements
+---
+
+```js
+measurements: [
+  "bicepsCircumference",
+  "centerBackNeckToWaist"
+]
+```
+
+An array with the names of the measurements required to draft this pattern. 
+
+<Note>
+
+###### Don't just make up names
+
+See [freesewing models](https://freesewing.dev/reference/packages/models) 
+for a list of measurement names already used in freesewing patterns.
+It is a [best practice](/guides/best-practices/reuse-measurements/) to stick to these names.
+
+</Note>

markdown/dev/reference/config/name/en.md

@@ -0,0 +1,9 @@
+---
+title: name
+---
+
+```js
+name: "sorcha"
+```
+
+A string with the name of your pattern.

markdown/dev/reference/config/optionalmeasurements/en.md

@@ -0,0 +1,21 @@
+---
+title: optionalMeasurements
+---
+
+```js
+optionalMeasurements: [
+  'highBust'
+]
+```
+
+An array with the names of optional measurements that can be used to draft this pattern. 
+
+<Note>
+
+###### Why would you want optional measurements?
+
+This is often used in combination with [the bust plugin](/reference/plugins/bust/) to 
+allow a pattern to be drafted to the `highBust` measurement rather than the 
+`chest` measurement, thereby providing better fit for people with breasts.
+
+</Note>

markdown/dev/reference/config/options/boolean/en.md

@@ -0,0 +1,16 @@
+---
+title: boolean
+---
+
+If your option is either `true` or `false`, or **on** or **off** or **yes** or **no**, you can use a boolean:
+
+Your boolean option should be an object with these properties:
+
+ - `bool` : Either `true` or `false` which will be the default
+
+```js
+options: {
+  withLining: { bool: true }
+}
+```
+

markdown/dev/reference/config/options/co

@@ -0,0 +1,231 @@
+---
+title: options
+---
+
+Options come in 6 varities:
+
+ - [Constants](#constants) : A value that can't be changed
+ - [Booleans](#booleans) : A value that is either `true` or `false`
+ - [Percentages](#percentages) : A value in percent, with minimum and maximum values
+ - [Millimeters](#millimeters) : A value in millimeter, with minimum and maximum values
+ - [Degrees](#degrees) : A value in degrees, with minimum and maximum values
+ - [Counters](#counters) : An integer value, with minimum and maximum values
+ - [Lists](#lists) : A list of options with a default
+
+Under the hood, millimeters, degrees, and counters are handled the same way. 
+We use different types because it easier to understand the nature of a given option.
+
+
+### Constants
+
+If your option is a scalar value (like a string or a number), it will be treated as a constant:
+
+```js
+options: {
+  collarFactor: 4.8
+}
+```
+
+Rather than define constants in your code, it's good practice to set them in your configuration file.
+This way, people who extend your pattern can change them if they would like to.
+
+### Booleans
+
+If your option is either `true` or `false, or **on** or **off** or **yes** or **no**, you can use a boolean:
+
+Your boolean option should be an object with these properties:
+
+ - `bool` : Either `true` or `false` which will be the default
+
+```js
+options: {
+  withLining: { bool: true }
+}
+```
+
+### Percentages
+
+Percentage options are the bread and butter of freesewing.
+Almost all your options will probably be percentages.
+They make sure that your pattern will scale regardless of size,
+and pass [the ant-man test](https://github.com/freesewing/antman).
+
+Your percentage option should be an object with these properties:
+
+ - `pct` : The percentage
+ - `min` : The minimul that's allowed
+ - `max` : The maximum that's allowed
+
+```js
+options: {
+  acrossBackFactor: { 
+    pct:  97, 
+    min:  93, 
+    max: 100 
+  }
+}
+```
+
+<Note>
+
+###### Percentage options will be divided by 100 when loaded
+
+You specify percentages in your config file. For example, `50` means 50%.
+When your configuration is loaded, those percentages will by divided by 100. 
+
+So a percentage of `50` in your config file will be `0.5` when you read out that option in your pattern.
+
+</Note>
+
+### Millimeters
+
+While we recommend using percentages where possible, sometimes that doesn't make sense.  
+For those cases, you can use millimeters.
+
+Your millimeter option should be an object with these properties:
+
+ - `mm` : The default value in millimeter
+ - `min` : The minimul that's allowed
+ - `max` : The maximum that's allowed
+
+```js
+options: {
+  elasticWidth: { 
+    mm:  35, 
+    min:  5, 
+    max: 80 
+  }
+}
+```
+
+### Degrees
+
+For angles, use degrees.
+
+Your degree option should be an object with these properties:
+
+ - `deg` : The default value in degrees
+ - `min` : The minimul that's allowed
+ - `max` : The maximum that's allowed
+
+```js
+options: {
+  collarAngle: { 
+    deg:  85, 
+    min:  60 
+    max: 130 
+  }
+}
+```
+
+### Counters
+
+For a given number of things, use counters.
+Counters are for integers only. Things like number of buttons and so on.
+
+Your counter option should be an object with these properties:
+
+ - `count` : The default integer value
+ - `min` : The minimal integer value that's allowed
+ - `max` : The maximum integer value that's allowed
+
+```js
+options: {
+  butttons: { 
+    count: 7, 
+    min:   4,
+    max:  12 
+  }
+}
+```
+
+### Lists
+
+Use a list option when you want to offer an array of choices.
+
+Your list option should be an object with these properties:
+
+ - `dflt` : The default for this option
+ - `list` : An array of available values options
+
+```js
+options: {
+  cuffStyle: { 
+    dflt: "angledBarrelCuff",
+    list: [
+      "roundedBarrelCuff",
+      "angledBarrelCuff"
+      "straightBarrelCuff"
+      "roundedFrenchCuff"
+      "angledFrenchCuff"
+      "straightFrenchCuff"
+    ]
+  }
+}
+```
+
+## Extra
+
+Patterns also take these configuration options to facilitate frontend integration:
+
+### design
+
+The name of the designer:
+
+```js
+design: "Joost De Cock"
+```
+
+### code
+
+The name of the developer:
+
+```js
+code: "Joost De Cock"
+```
+
+### type
+
+Either `pattern` or `block`.
+
+```js
+type: "pattern"
+```
+
+### difficulty
+
+A `1` to `5` difficulty score that indicates how hard it is to make the pattern:
+
+```js
+difficulty: 3
+```
+
+### tags
+
+A set of tags to allow filtering of patterns on the website:
+
+```js
+tags: ["underwear", "top", "basics"],
+```
+
+### optionGroups
+
+Organises your pattern options in groups. It expects an object where the key is the group title,
+and the value an array of options:
+
+```js
+optionGroups: {
+  fit: ["chestEase", "hipsEase", "stretchFactor"],
+  style: [
+    "armholeDrop",
+    "backlineBend",
+    "necklineBend",
+    "necklineDrop",
+    "shoulderStrapWidth",
+    "shoulderStrapPlacement",
+    "lengthBonus"
+  ]
+} 
+```
+
+

markdown/dev/reference/config/options/constant/en.md

@@ -0,0 +1,17 @@
+---
+title: constant
+---
+
+If your option is a scalar value (like a string or a number), it will be treated as a constant:
+
+```js
+options: {
+  collarFactor: 4.8
+}
+```
+
+<Tip>
+Rather than define constants in your code, it's good practice to set them in your configuration file.
+This way, people who extend your pattern can change them if they would like to.
+</Tip>
+

markdown/dev/reference/config/options/counter/en.md

@@ -0,0 +1,22 @@
+---
+title: counter
+---
+
+For a given number of things, use a counter.
+Counters are for integers only. Things like number of buttons and so on.
+
+Your counter option should be an object with these properties:
+
+ - `count` : The default integer value
+ - `min` : The minimal integer value that's allowed
+ - `max` : The maximum integer value that's allowed
+
+```js
+options: {
+  butttons: { 
+    count: 7, 
+    min:   4,
+    max:  12 
+  }
+}
+```

markdown/dev/reference/config/options/degrees/en.md

@@ -0,0 +1,21 @@
+---
+title: degrees
+---
+
+For angles, use degrees.
+
+Your degree option should be an object with these properties:
+
+ - `deg` : The default value in degrees
+ - `min` : The minimul that's allowed
+ - `max` : The maximum that's allowed
+
+```js
+options: {
+  collarAngle: { 
+    deg:  85, 
+    min:  60 
+    max: 130 
+  }
+}
+```

markdown/dev/reference/config/options/en.md

@@ -0,0 +1,14 @@
+---
+title: options
+---
+
+Options come in 6 varities:
+
+<ReadMore list />
+
+<Note>
+
+Under the hood, millimeters, degrees, and counters are handled the same way. 
+We use different types because it easier to understand the nature of a given option.
+
+</Note>

markdown/dev/reference/config/options/list/en.md

@@ -0,0 +1,26 @@
+---
+title: list
+---
+
+Use a list option when you want to offer an array of choices.
+
+Your list option should be an object with these properties:
+
+ - `dflt` : The default for this option
+ - `list` : An array of available values options
+
+```js
+options: {
+  cuffStyle: { 
+    dflt: "angledBarrelCuff",
+    list: [
+      "roundedBarrelCuff",
+      "angledBarrelCuff"
+      "straightBarrelCuff"
+      "roundedFrenchCuff"
+      "angledFrenchCuff"
+      "straightFrenchCuff"
+    ]
+  }
+}
+```

markdown/dev/reference/config/options/millimeter/en.md

@@ -0,0 +1,31 @@
+---
+title: millimeter
+---
+
+While we recommend using percentages where possible, sometimes that doesn't make sense.  
+
+For those cases, you can use a millimeter option which 
+should be an object with these properties:
+
+ - `mm` : The default value in millimeter
+ - `min` : The minimul that's allowed
+ - `max` : The maximum that's allowed
+
+```js
+options: {
+  elasticWidth: { 
+    mm:  35, 
+    min:  5, 
+    max: 80 
+  }
+}
+```
+
+<Tip>
+
+##### When to use a millimeter option
+
+You should only use millimeter when the option refers to a physical object
+that comes in certain sizes. 
+
+</Tip>

markdown/dev/reference/config/options/percentage/en.md

@@ -0,0 +1,36 @@
+---
+title: percentage
+---
+
+Percentage options are the bread and butter of freesewing.
+
+Almost all your options will probably be percentages.
+They make sure that your pattern will scale regardless of size.
+
+Your percentage option should be an object with these properties:
+
+ - `pct` : The percentage
+ - `min` : The minimul that's allowed
+ - `max` : The maximum that's allowed
+
+```js
+options: {
+  acrossBackFactor: { 
+    pct:  97, 
+    min:  93, 
+    max: 100 
+  }
+}
+```
+
+<Note>
+
+###### Percentage options will be divided by 100 when loaded
+
+You specify percentages in your config file. For example, `50` means 50%.
+When your configuration is loaded, those percentages will by divided by 100. 
+
+So a percentage of `50` in your config file will be `0.5` when you read out that option in your pattern.
+
+</Note>
+

markdown/dev/reference/config/parts/en.md

@@ -0,0 +1,23 @@
+---
+title: parts
+---
+
+```js
+parts: [
+  "front",
+  "back"
+]
+```
+
+An array that lists your (additional) pattern parts. The name must be the key the `pattern.parts` object.
+
+<Tip>
+
+###### This does not need to be an exhaustive list of all parts in your pattern.
+
+This list of parts is needed for the `draft()` method to figure out what
+parts need to be drafted.
+So if parts are included in the `dependencies`, `inject`, or `hide` configuration, 
+there's no need to include them here, as we already know of their existence.
+
+</Tip>

markdown/dev/reference/config/ui/code/en.md

@@ -0,0 +1,10 @@
+---
+title: code
+---
+
+```js
+code: "Joost De Cock",
+```
+
+The name of the developer.
+

markdown/dev/reference/config/ui/department/en.md

@@ -0,0 +1,14 @@
+---
+title: department
+---
+
+```js
+department: "menswear",
+```
+
+One of the following:
+
+ - menswear
+ - womenswear
+ - unisex
+ - accessories

markdown/dev/reference/config/ui/design/en.md

@@ -0,0 +1,9 @@
+---
+title: design
+---
+
+```js
+design: "Joost De Cock",
+```
+
+The name of the designer.

markdown/dev/reference/config/ui/difficulty/en.md

@@ -0,0 +1,9 @@
+---
+title: difficulty
+---
+
+```js
+difficulty: 3
+```
+
+A `1` to `5` difficulty score that indicates how hard it is to make the pattern.

markdown/dev/reference/config/ui/en.md

@@ -0,0 +1,14 @@
+---
+title: UI configuration
+order: 100
+---
+
+Patterns also take these configuration options to facilitate UI integration:
+
+<ReadMore list />
+
+<Tip>
+
+UI = User Interface. Like a website or mobile app
+
+</Tip>

markdown/dev/reference/config/ui/optiongroups/advanced-option-group/en.md

@@ -0,0 +1,20 @@
+---
+title: The advanced option group
+---
+
+Naming an option group `advanced` will hide it by default from the user
+unless they enable *expert mode*.
+
+```js
+optionGroups: {
+  fit: ["chestEase", "hipsEase", "stretchFactor"],
+  style: ["armholeDrop", "backlineBend"],
+  advanced: [ "plutoniumCount" ]
+} 
+```
+
+<Tip>
+
+The `advanced` option group can also have nested groups
+
+</Tip>

markdown/dev/reference/config/ui/optiongroups/en.md

@@ -0,0 +1,29 @@
+---
+title: optionGroups
+---
+
+Organises your pattern options in groups. 
+It expects an object where the key is the group title, and the value an array of options:
+
+```js
+optionGroups: {
+  fit: ["chestEase", "hipsEase", "stretchFactor"],
+  style: [
+    "armholeDrop",
+    "backlineBend",
+    "necklineBend",
+    "necklineDrop",
+    "shoulderStrapWidth",
+    "shoulderStrapPlacement",
+    "lengthBonus"
+  ]
+} 
+```
+
+<Note>
+
+Options that are not included in the `optionGroup` configuration won't be
+exposed in the frontend and thus will be unavailable to the user.
+
+</Note>
+

markdown/dev/reference/config/ui/optiongroups/nested-optiongroups/en.md

@@ -0,0 +1,27 @@
+---
+title: Nested option groups
+---
+
+You can create sub-groups within an option group:
+
+```js
+optionGroups: {
+  style: [
+    'hemStyle',
+    'hemCurve',
+    {
+      closure: [
+        'extraTopButton',
+        'buttons',
+        'buttonFreeLength'
+      ]
+    },
+  ]
+}
+```
+
+<Warning>
+Only create subgroups one level deep. 
+We do not support groups in groups in groups.
+</Warning>
+

markdown/dev/reference/config/ui/tags/en.md

@@ -0,0 +1,9 @@
+---
+title: tags
+---
+
+```js
+tags: ["underwear", "top", "basics"],
+```
+
+A set of tags to allow filtering of patterns on the website.

markdown/dev/reference/config/ui/type/en.md

@@ -0,0 +1,12 @@
+---
+title: type
+---
+
+```js
+type: "pattern",
+```
+
+One of the following:
+
+ - pattern
+ - block

markdown/dev/reference/config/version/en.md

@@ -0,0 +1,10 @@
+---
+title: version
+---
+
+```
+version: "0.3.1"
+```
+
+The version of your pattern.
+