helix
helix copied to clipboard
helix-editor
Tutor/shell commands
Provide tutor about the "shell command and related" tooling offered by helix: :sh , :insert-output , :pipe , and the likes.
Just a kind reminder on this :) . Any thoughts / comments? @David-Else you have been interested in these "tutor extension" PRs in the past - would be great if you have feedback on this one too :) .
It looks awesome! Sorry I don't have time to give a full review right now, but I have made some suggestions.
Not sure who could review / approve this? :) Maybe @pascalkuthe / @the-mikedavis ? :) (sorry if tagging you is too pushy - if so let me know and I wont do it in the future :) taking the liberty to do so here as this is a minor documentation update, so should be quite benign to approve and merge :) ).
Sorry for the delay of answer!
Thank you for your feedback @the-mikedavis ! :) A few questions:
Chapters 14.2 and 14.3 are to tall: each chapter in the tutor should have a fixed height (19 rows I believe, 22 including the header).
Me being curious: is there a strong reason for using exactly 22 rows? I understand it can be a goal if there are no other conflicting "requirements", but in case we have a bit more to explain, is it really a big issue to use a bit more rows? I can cut the chapters in more subchapters though if you want :)
I'm wary of adding this much content about shell interaction especially because it's unix specific: in its current form it's not useful to readers on Windows.
Yes, I understand that this is an issue... At the same time, I guess that many of the power users / command line users are running either on some unix system, or through the WSL? Would it be acceptable to you if I split the chapters to have at least the key simple ones both working on unix and windows?
I would like to keep the jq example if this is possible, because it is a really powerful use example - at least, it was very interesting to me to learn about it. But if you have strong opinions on this, I can remove it.