There's a weird asymmetry between meta recipes and examples

[svenstaro]

This is not really a feature request but a general thought. It's not perfectly clear to me as a user whether to follow the recipes (which are essentially copy-n-paste examples but in markdown) or the examples (which are also essentially copy-n-paste examples but as yml). They both don't have quite the same contents but they are pretty similar in what they do in most cases.

I think this is weirdly asymmetrical and should be consolidated one way or the other.

Maybe I'm missing something but I just stumbled upon this and am a bit confused. I do like the idea of an entrypoint repo (like the meta repo) as it guides users but then it just confused me a bit.

[svenstaro]

To note, I think I prefer the narrated approach that is currently employed by the recipes. I'm thinking: Clear out the recipes from this repo and migrate them into the examples repo and then do everything in a narrated markdown style?

[svenstaro]

Alright, I just understood that the examples repo is actually a live feature demonstration. Well, I don't even know what to do with this issue right now. I'll just leave it open for the time being. Feel free to close it when you've read it.