docs: Add a tutorial for pystack remote - deadlock example

[manasomali]

Issue number of the reported bug or feature request: #53

Describe your changes
Add the first tutorial about how to use PyStack to profiling the deadlock problem.

Testing performed
No tests added.

Additional context
Made during pycon2024 sprint. First day.

[manasomali]

Sorry, fixing the lint.

[sarahmonod]

First of all, thanks for working on this! This is fantastic and a really helpful addition. I think there are a few things that can be improved though, that I have detailed below.

[manasomali]

@gusmonod I don't know how to solve the error from build docs step. 🙃

[manasomali]

PR updated, added a new section related to the use of --locals. Along with the recommended improvements in the deadlock.py script.

[manasomali]

The test_in_alpine step is failing, what is the solution for this issue? 🤔

[godlygeek]

The test_in_alpine step is failing, what is the solution for this issue? 🤔

That's fixed by #185

I'll pick this PR up soon and move it forward.

All requested changes have been addressed

[godlygeek]

I'll pick this PR up soon and move it forward.

"soon" 😅

I've slightly tweaked some of the wording here and there, and dropped the requirements-tutorial.txt in favor of just doing a python3 -m pip install pystack, at least for now. Otherwise, this LGTM!

Thanks so much for the contribution, @manasomali!