Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Foundations Command Line Basics: External UNIX Shell course uses Nano #27872

Closed
2 of 3 tasks
MaoShizhong opened this issue Apr 27, 2024 · 5 comments
Closed
2 of 3 tasks

Comments

@MaoShizhong
Copy link
Contributor

Checks

Describe your suggestion

Command Line Basics includes an assignment to swcarpentry's UNIX Shell course. In particular, the Working with Files and Directories section includes some instruction on creating text files in Nano. It also includes a note box within it talking about "Which Editor?", with some language that some people in Discord have thought might make the thought of using editors other than VSCode appealing.

Either way, I find it odd that an assignment we have includes a short snippet that makes people use Nano, which we'll never touch again afterwards. And that's before people are probably clued fully clued in one what to do and not do. Example of recent confusion from a learner about which text editors.

The previous lesson is on text editors where we make the VSCode recommendation.
I'm in a mind that an 80:20 resolution for this would be to add a note underneath
image
that provides the code draft.txt command instructions instead, and instructions for saving that file in VSCode, as opposed to using Nano.

Path

Foundations

Lesson Url

https://www.theodinproject.com/lessons/foundations-command-line-basics#assignment

(Optional) Discord Name

No response

(Optional) Additional Comments

No response

@MaoShizhong
Copy link
Contributor Author

@TheOdinProject/foundations Any thoughts on this?

@scheals
Copy link
Contributor

scheals commented Apr 27, 2024

I was not asked but knowing how to use nano is a good thing - if learners don't configure git correctly, their default text editor will be nano. Many answers on SO or AskUbuntu suggest using nano and people don't realise they could use a different text editor. Same would apply for sudoedit if no editor is provided.

My recollection isn't that great but I do believe using nano never was a pain point ever for learners while going through this content. The note is quite clear that many programmers are fans of particular editors and that VSCode belongs to a different group (graphical) than vim and emacs.

Furthermore, this resource has historically caused problems for WSL2 users (#27338) so stacking even more exceptions would put inclusion of this great resource in jeopardy. I call it a great resource because ever since the lesson has been revamped to use it, the volume of questions relating to using CLI has dropped significantly.

@MaoShizhong
Copy link
Contributor Author

Not an issue exclusive to maintainer feedback - your insight and opinion is also absolutely kore than valid, thank you! Just thought since I'm personally less familiar with this part and potential community pain points, I'd open the discussion in case there are things that are deemed appropriate to do!

@thatblindgeye
Copy link
Contributor

Agreed on not stacking exceptions. It may also be more confusing or easy to forget any note about using some other command rather than what the linked resource says, since the nano command isn't mentioned until the 5th or 6th heading.

If this isn't a prevalent issue raised on Discord I'm not sure we need to really address it. If we want to, maybe just a note about how nano is used for this resource and may be something they use again (pretty sure at some point I've had to use nano when dealing with commit messages within the VS code terminal...)

@MaoShizhong
Copy link
Contributor Author

That's fair enough! Since it doesn't look like it's been a notable source of confusion, let's close this and only address if it actually becomes one.

@MaoShizhong MaoShizhong closed this as not planned Won't fix, can't repro, duplicate, stale May 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants