Improve Blueprints documentation experience by providing live examples

[juanmaguitar]

Apply direct blueprint configurations to the https://playground.wordpress.net/ URL is a very powerful way of using WordPress Playground with tons of applications but unfortunately, the process of creating the JSON configuration in the proper format (encode, remove spaces...) could be a blocker for several developers (a bad formatted character in the URL can make the whole playground not to work as desired), especially for those learning about blueprints.

I think the Blueprints documentation (and use) experience could be improved by a lot by providing live examples of its properties, resource, and steps with a tool such as https://sejas.es/playground ( see example)

I propose the following actions:

• Migrate https://sejas.es/playground to https://playground.wordpress.net/blueprints
• Provide examples of properties, resources, and steps of blueprints with links to these configurations applied to https://playground.wordpress.net/blueprints

cc: @sejas @adamziel

[adamziel]

This plays well with what @dmsnell said:

if we want AI generated Blueprints maybe we should create a blueprint library with various documents and JSON comments, narrative describing what they do and how

[adamziel]

Also I'm on board with this:

Migrate https://sejas.es/playground to https://playground.wordpress.net/blueprints

FYI @mtias

[danielbachhuber]

@adamziel I think @ajitbohra's is a little more polished... WordPress/blueprints#44

@ajitbohra Would you want to contribute yours?

[juanmaguitar]

I think @ajitbohra's is a little more polished... WordPress/blueprints#44

I think both tools are useful for different use cases:

• @ajitbohra's tool → to generate a blueprint from scratch and learn about them
• @sejas's tool → to quickly test a blueprint and see blueprint examples in action

Ideally, we can have both available for playground users 🤞

[ajitbohra]

@danielbachhuber would love to contribute, The repo is public https://github.com/lubusIN/wp-playground-blueprint-builder/
need to iron out a few issues.

@juanmaguitar agrees both tools can be useful. Have something similar on the roadmap to add to the tool, allowing to load blueprint JSON.

We can have the best of both by merging the functionality so it serves as a tool to load, edit, and play around with the blueprint.