open-feature / playground

OpenFeature SDK demos and experimentation
https://openfeature.dev
Apache License 2.0
55 stars 27 forks source link

Add online browser-only tutorial #76

Closed agardnerIT closed 2 years ago

agardnerIT commented 2 years ago

I will own this and create a PR as a PoC but I think it'd be nice to give new users the option to try this entirely in browser - rather than having to provision or install infrastructure.

There are various platforms available to do this like Killercoda and Instruqt.

For this PoC I will use Killercoda as:

1) It is free for authors and the audience 2) OpenFeature can be listed on their homepage (mutual publicity) 3) An optional paid membership would allow scenarios to be embedded onto other webpages (ie. natively embedded on openfeature.dev and available sans-login) 4) Tutorials can be chained to make courses - so if examples get more complex, we can offer different 5) I'm familiar with it

If anyone has strong feelings, reasons for using / not using this platform, please chime in! If you have an alternative - let's collaborate and we can figure out which is best.

beeme1mr commented 2 years ago

Thanks @agardnerIT!

agardnerIT commented 2 years ago

Work in Progress demo: https://killercoda.com/agardnerit/scenario/openfeature-demo

Feedback please...

This is currently under my username but we can transfer to open-feature and thus get a URL like https://killercoda.com/openfeature

For that to happen, Killercoda needs a dedicated repo for their tutorials (for example, mine is https://github.com/agardnerit/killercoda_tutorials). Then a hook is set up on the repo and thus any changes on main are auto-synced by the platform.

If we get to this point, we can ask the Killercoda team to list OpenFeature on their homepage.

Embedding scenarios without a login on the OpenFeature.dev site is only possible with a paid account.

beeme1mr commented 2 years ago

I tested the demo and it worked great! It would be nice to add one more step that talks about adding additional providers if possible.

beeme1mr commented 2 years ago

Is it possible to create an organization account in Killercoda or does it need to be associated with a single user?

agardnerIT commented 2 years ago

From the killercoda team: It's not possible if the Github account is behind a custom/organisation url

beeme1mr commented 2 years ago

@agardnerIT, could you please add a section to the readme now that we have Killercoda setup?

beeme1mr commented 2 years ago

Killercoda has been configured.

https://killercoda.com/open-feature