3 ms·
Thanks for taking the time to address my concerns. I am still very much open to trying it again in the future, but just like you I have time constraints and hav
by zamalek 2y ago
Thanks for taking the time to address my concerns. I am still very much open to trying it again in the future, but just like you I have time constraints and have to find a time box for it.
What I would really like to see an extremely simple walkthrough that covers some really basic scenarios without the ceremony of setting up a new JJ repo, for busy people who want to pilot something new - that covers all of:
* Central repository using branches (single remote) OR GitHub-style forked repository (multiple remotes)
* Merge-based workflow OR rebase-based workflow, both without conflicts
Using github.com/martinvonz/jj as an example repo - show us how to draw the entire owl
Take me from opening a terminal in order to make my changes, to creating a commit with those changes, merging/rebasing the trunk to my branch, to pushing it to my remote branch. Remember: I (and the rest of the 80%) have a job to do, so we want the cliff notes to reach success, and then we can dive deeper into things as we encounter them naturally.
Once you have the trivial workflow out of the way you can progressively disclose other things. For example, for conflict resolution/merging, you could start with an example that's already in a conflicted state and walk through that - i.e. an example that solely focuses on a specific issue. Remember, your new users want to achieve things first - think from their perspective "oh shit, this rebase has resulted in a conflict, what do I do?" or "my team uses gitflow, how do I interact with that?" Tiny little tutorials that cover common scenarios go a lot further than a monolithic detailed tutorial.
- steveklabnik 2y agoThank you for the input! > just like you I have time constraints and have to find a time box for it. 100%, even with jj itself, it took me two or three tries hearing about it before I decided to try it, and then twice of giving it a shot before it stuck. Once it stuck, it really stuck, for me at least. > Once you have the trivial workflow out of the way you can progressively disclose other things. This is sorta kinda how I have my tutorial set up, but I suspect I go a bit slow for you at the start. I tend to be more of a bottom-up learner myself, and this is a common criticism of the Rust book. Part of the reason I wanted to wait before upstreaming what I have is so that I have the freedom for more radical changes, so I will give what you're saying some consideration. I 100% agree that workflows are super super important to demonstrate, it was honestly kind of some of the motivation to write this tutorial in the first place.