Document CustomSessionStorage example

[thecodepixi]

WHY are these changes introduced?

Fixes #121

WHAT is this pull request doing?

Adds documentation and example code for a CustomSessionStorage solution.

Type of change

• Patch: Bug (non-breaking change which fixes an issue)
  - [ ] Minor: New feature (non-breaking change which adds functionality)
  - [ ] Major: Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist

• I have added a changelog entry, prefixed by the type of change noted above
  - [ ] I have added/updated tests for this change
  - [ ] I have documented new APIs/updated the documentation for modified APIs (for public APIs)

[thecodepixi]

I have a feeling this will need a bit more polish. Curious for feedback on both the general content and the code samples. I'm also curious what we should do with the existing docs around session handling under Known Issues as it applies to CustomeSessionStorage.

[paulomarg]

I have a feeling this will need a bit more polish. Curious for feedback on both the general content and the code samples. I'm also curious what we should do with the existing docs around session handling under Known Issues as it applies to CustomeSessionStorage.

I'd edit the current page to say something like 'you'll need to implement your own class, here is one way to do it'.

[gfscott]

Looks great!

[thecodepixi]

A couple updates: Incorporated the suggested changes (thanks for all the input!). I also added some closing remarks to the end of the guide since it ended a bit abruptly, and called out that this is only one of many possible solutions. I'm curious about how the update to the install dependencies section looks. The Redis docs only have one suggested installation, so I added a note to callout that Mac users can install with homebrew.

[paulomarg]

I'm curious about how the update to the install dependencies section looks

Looks great to me. It clearly states that it is one possible way of doing it, and provides instructions on how to get started with it.

I would however, consider changing the current notes on sessions page to link to this one instead of providing its own example, which is too simplistic compared to this one!

[paulomarg]

Are we updating the getting started guide index accordingly?

[thecodepixi]

I took a look and don't think anything we're doing here effects the getting started guide.

[paulomarg]

LGTM, but there is one thing that got mentioned on a different issue - let's make it clear that storeCallback expects to be called multiple times for the same session id, so it should be able to update existing entries.

[thecodepixi]

LGTM, but there is one thing that got mentioned on a different issue - let's make it clear that storeCallback expects to be called multiple times for the same session id, so it should be able to update existing entries.

Good point! I will add a call-out/note about that and then get this merged in.

[paulomarg]

LGTM!