pulumi / docs

All things Pulumi docs!
https://pulumi.com
Apache License 2.0
129 stars 221 forks source link

[Epic] Author "the minimum you need to know about language X" guides #11788

Open joeduffy opened 4 years ago

joeduffy commented 4 years ago

Right now we assume folks wanting to learn Pulumi understand their language of choice. For many newcomers, however, that's not the right assumption to make.

Let's write a series of user guides that detail the minimum you need to know about language X to be successful with Pulumi. It turns out you can get started with a vast subset -- especially in languages like Python -- and that we should be able to give you a quick 20 minute tour of that subset.

joeduffy commented 3 years ago

By the way, I assume Chef broke similar ground here, since they used Ruby and a fair bit of their community came from non-developer backgrounds. I found this guide (https://docs.chef.io/ruby/) which is close to what I had imagined, although it's a bit more of a holistic end to end tour of the syntax, versus "the minimum features and best practices you need to know."

susanev commented 2 years ago

@nimbinatus or @cnunciato would either of yall like to add this to ur backlogs?

nimbinatus commented 2 years ago

I'll handraise to shepherd this along. I probably won't be the person to write all of them (my C# is... entertaining), but I can at least start something.

jaxxstorm commented 2 years ago

@nimbinatus I'm actually working on this, albeit very slowly.

nimbinatus commented 2 years ago

@jaxxstorm cool beans! If you want some help, I'm happy to assist.

mattstratton commented 2 years ago

By the way, I assume Chef broke similar ground here, since they used Ruby and a fair bit of their community came from non-developer backgrounds

early versions of chef fundamentals training had exactly this ("just enough ruby for chef") as a section

https://github.com/chef-boneyard/chef-fundamentals/blob/dd718a22ded9b690609c7a643eb6b41e266c0d5d/slides/just-enough-ruby-for-chef/01_slide.md

cnunciato commented 2 years ago

Adding Lee's in-progress doc here for reference: https://docs.google.com/document/d/14w1NFUDPxT3qOMEtycMTmq6J6ptJ36r0B9sVCt9wO6A/edit#heading=h.widltx1dim94

We're picking it up from here and planning on getting at least one of these docs out this quarter (looks like TS to begin with).