Feature Flags Tutorial

[yakkomajuri]

Adding tutorials to our Docs - currently work in progress since we would prefer to launch a few tutorials at once to populate the page.

Overall look:

[jamesefhawkins]

Main one is the point on the structure. I don't think it'll change the content hugely but I think it'd make it more readable.

[jamesefhawkins]

These images are hard to see without clicking into them because the page width is narrow. The consistency however (the whole screen each time) does make them look a lot nicer.

Could we expand the width a little?

[yakkomajuri]

Will take a look

[yakkomajuri]

I can only make them marginally larger - to make them significantly bigger would actually require some deeper tweaks

[yakkomajuri]

@jamesefhawkins take a look now - the tutorial should have incorporated your overall feedback.

I was also thinking it'd be cool to use a feature flag to release these i.e. we could merge the tutorials and just turn the flag on when we're satisfied with the number.

The problem is that using feature flags with the PostHog Gatsby plugin is a bit tricky. Will take a deeper look into it but it might just end up being too much of a hassle with the way the plugin is structured.

[yakkomajuri]

Managed to find a workaround.

So now I've implemented a feature flag that hides the Tutorials section from the menu until we activate it. We can therefore merge tutorials in separate PRs and just toggle that on when we're ready.

"You who caught the turtles better eat them"

i.e. It is only right we make use of our own functionality ("We use PostHog to track PostHog")

[yakkomajuri]

@jamesefhawkins Because of the feature flag, this should be ready to go by itself

[yakkomajuri]

To find the tutorial:

https://pr-438.d1armtyn8hqyjr.amplifyapp.com/docs/tutorials/feature-flags

[jamesefhawkins]

Thank you Yakko! I fixed a conflict with the sidebar, I'm now just waiting to check the build then happy for you to merge.