Getting started (py)

[teh-cmc]

• For Python users
• For Rust users
• Getting started with Python

This doesn't cover Getting started with Rust on purpose, let's polish the python one first and then it'll be mostly a job of translating content from one ecosystem to another.

Future technical improvements

• Incremental code widget to make following the tutorial much easier
• Better production value for screenshots & GIFs (well, until we have stable Rerun Web)
• Grab code directly from the main repo during build rather than copy paste
• "Copy to clipboard" on our source snippets would also be hotness (@jleibs)
• Other stuff I don't remember right now

[Wumpf]

OMG this is great!!!

At first I thought it's a bit too conversational, but as a tutorial this is actually super nice; it's not the reference after all

[teh-cmc]

Update: there's gonna be some overlap between the "For Python/Rust users" pages and the Python SDK and Rust SDK READMEs, so make sure it's all coherent.

[nikolausWest]

This is really really good! Great job!

Other than my comment on adding some code comments to one section, the only thing I'd change is to use way less exclamation marks "!". It isn't needed and actually doesn't enhance the text.

On the video front I'd very strongly consider just putting them on youtube. I'll help out if you want to go that route.

[Wumpf]

🚢 ❤️

[nikolausWest]

One more thought: we have support for code switching so we could consider only having a single tutorial where you just toggle code snippets between Rust and Python

[Wumpf]

that would require some reformulating here and there but that would not only look cool but also saves us a lot of work and maintenance!

[teh-cmc]

Yeah we've talked about this already: it will all depend on how different the two tutorials end up looking, which at this point I'm not able to say.