Docs sync @ 52b7f86 Updated TOC in FAQ docs (#49)

docs/features/note-properties.md

@@ -1,30 +1,50 @@
 ---
 type: feature
-keywords: hello world
+keywords: hello world, bonjour
+tags: [hello, bonjour]
 ---
 
 # Note Properties
 
-At the top of the file you can have a section where you define your properties.
+At the top of the file you can have a section where you define your properties. This section is known as the [Front-Matter](https://learn.cloudcannon.com/jekyll/introduction-to-jekyll-front-matter/) of the document and uses [YAML formatting](https://www.codeproject.com/Articles/1214409/Learn-YAML-in-five-minutes).
 
-> Be aware that this section needs to be at the very top of the file to be valid
+> Be aware that this YAML section needs to be at the very top of the file to be valid.
 
 For example, for this file, we have:
 
-```text
+```markdown
 ---
 type: feature
-keywords: hello world
+keywords: hello world, bonjour
 ---
 ```
 
-Those are properties.
-Properties can be used to organize your notes.
+This sets the `type` of this document to `feature` and sets **three** keywords for the document: `hello`, `world`, and `bonjour`. The YAML parser will treat both spaces and commas as the seperators for these YAML properties. If you want to use multi-word values for these properties, you will need to combine the words with dashes or underscores (i.e. instead of `hello world`, use `hello_world` or `hello-world`).
+
+> You can set as many custom properties for a document as you like, but there are a few [special properties](#special-properties) defined by Foam.
 
 ## Special Properties
 
 Some properties have special meaning for Foam:
 
-- the `title` property will assign the name to the note that you will see in the graph, regardless of the filename or the first heading (also see how to [[write-notes-in-foam]])
-- the `type` property can be used to style notes differently in the graph (also see [[graph-visualization]])
-- the `tags` property can be used to add tags to a note (see [[tags-and-tag-explorer]])
+| Name                 | Description        |
+| -------------------- | ------------------- |
+| `title` | will assign the name to the note that you will see in the graph, regardless of the filename or the first heading (also see how to [[write-notes-in-foam]])      |
+| `type`         | can be used to style notes differently in the graph (also see [[graph-visualization]]). The default type for a document is `note` unless otherwise specified with this property.       |
+| `tags`          | can be used to add tags to a note (see [[tags]])      |
+
+For example:
+
+```markdown
+---
+title: "Note Title"
+type: "daily-note"
+tags: daily, funny, planning
+
+---
+```
+
+## Foam Template Properties
+
+There also exists properties that are even more specific to Foam templates, see [[note-templates#Metadata]] for more info.
+