✨ Add docs for the new Session tag

Author: jackmcdade

assets/examples/session-dump.png

@@ -0,0 +1,18 @@
+---
+title: Session:Dump
+overview: The session:dump tag is used to inspect the user session for debugging purposes.
+id: d1ef36ac-7d21-40b2-a7fc-b53a0be3c79c
+---
+## Usage
+
+You can dump the contents of the user session to aid with development.
+```
+{{ session:dump}}
+```
+
+It will be injected into the rendered page in your browser.
+
+<div class="screenshot">
+    <h3>Preview</h3>
+    <img src="/assets/examples/session-dump.png" alt="Session Dump">
+</div>

content/collections/tags/session-dump.md

@@ -0,0 +1,20 @@
+---
+title: Session:Flash
+overview: The session:flash tag is used to store data for a single request.
+id: 29957a36-a15a-4fd0-9342-b829b6235fea
+---
+## Usage
+
+Flash data is only kept for a single request. It is generally used for success/failure messages that remove themselves automatically.
+
+Setting and retrieving flash data works in exactly the same fashion as regular session data.
+```
+{{ session:flash success="true" message="You did it!" }}
+```
+
+The next (and only next) request will then have those variables available for you.
+
+```
+{{ session:success }} ~> true
+{{ session:message }} ~> You did it!
+```

content/collections/tags/session-flash.md

@@ -0,0 +1,14 @@
+---
+title: Session:Flush
+overview: The session:flush tag is used to clear the entire user session.
+id: 1f522665-9fc2-4c9f-9594-04a518c51b39
+---
+## Usage
+
+Data set in the session will be available in all requests until such time that the session is cleared, either over time (sessions eventually expire) or intentionally.
+
+The flush tag will wipe the entire session. Keep in mind this will also sign a user out if they're signed in.
+
+```
+{{ session:flush }}
+```

content/collections/tags/session-flush.md

@@ -0,0 +1,19 @@
+---
+title: Session:Forget
+overview: The session:forget tag is used to remove data from the user session.
+id: be024503-9796-4f2f-9c75-548e2ea09cec
+---
+## Usage
+
+Data set in the session will be available in all requests until such time that the session is cleared, either over time (sessions eventually expire) or intentionally.
+
+Remove variables from the session by passing a collection of keys into the tag.
+```
+{{ session:forget keys="likes|referral" }}
+```
+
+Or you can wipe the entire session with the flush tag. Keep in mind this will also sign a user out if they're signed in.
+
+```
+{{ session:flush }}
+```

content/collections/tags/session-forget.md

@@ -0,0 +1,53 @@
+---
+title: "Session:Set"
+overview: "The session:set tag is used to store and persist data in the user session."
+id: 90796c5b-6b11-4b02-9e6b-fd70211c825a
+---
+## Usage
+
+Data set in the session will be available in all future requests until such time that the session is cleared, either over time (sessions eventually expire) or intentionally. Session variables can be retrieved with the base [session](/tags/session) tag.
+
+This can be used for many different things. For example, you could set a set a variable if a user has filled out a special survey form.
+
+```
+{{ session:set entered_survey="true" }}
+```
+
+Later you could decide to show the user has filled out the form.
+
+```
+{{ session }}
+    {{ if entered_survey }}
+        <p>You already filled out the form.</p>
+    {{ /if }}
+{{ /session }}
+```
+
+## Multiple Variables
+
+You can set multiple variables at once, and reference interpolated data just like all other tags.
+
+```
+{{ session:set likes="hats" :referral="get:ref" }}
+```
+
+## Tag Pair
+This tag is also available as a pair, which allows you to display any data immediately if you so desire.
+
+```
+{{ session:set likes="books" }}
+    <p>You like {{ likes }}, huh?</p>
+{{ /session:set }}
+```
+
+## Setting Array Data
+
+You can even set array data with dot notation.
+
+```
+{{ session:set likes.books="true" likes.hats="true" }}
+```
+
+## Forgetting Data
+
+You can remove data from the session [session:forget](/tags/session-forget), and flush the entire session with [session:flush](/tags/session-flush).

content/collections/tags/session-set.md

@@ -0,0 +1,46 @@
+---
+title: Session
+description: "Get, set, and forget data in your user's session."
+overview: Sessions provide a stateless way to store information about the user across requests. The session tag will let you get, set, and forget session data.
+is_parent_tag: true
+id: c15836c2-808d-4260-9d01-e5a569da5b5a
+---
+## Retrieving Session Data
+
+You can use `{{ session }}` as a tag pair to access all the data inside your user's session.
+
+```
+{{ session }}
+    {{ message }}
+{{ /session }}
+```
+
+```.output
+Welcome to the session.
+```
+
+You can also retrieve single variables with a single tag syntax.
+
+```
+{{ session:message }}
+```
+
+## Aliasing
+
+If you need extra markup around your session data, you can _alias_ a new child array variable.
+
+```
+{{ session as="sesh" }}
+  {{ sesh }}
+    {{ message }}
+  {{ /sesh }}
+{{ /session }}
+```
+
+## Setting and Forgetting
+
+You can set data with [session:set](/tags/session-set), flash data with [session:flash](/tags/session-flash), forget it with [session:forget](/tags/session-forget), and flush the entire session with [session:flush](/tags/session-flush).
+
+## Debugging
+
+If you want to peek into the session and check the data, do so with with [session:dump](/tags/session-dump) or the [debug bar](/debugging#debug-bar).