LibraryCarpentry / lc-shell

Library Carpentry: The UNIX Shell
https://librarycarpentry.org/lc-shell/
Other
28 stars 86 forks source link

Adding an alert box in lesson 2 to faciliate learner's understanding on output of home directory (under pwd) #238

Open kenlhlui opened 10 months ago

kenlhlui commented 10 months ago

How could the content be improved?

Hi all,

I suggest that the LC shell episode, lesson 2, should also include an alert box like the sw carpentry shell lesson, that indicates the variation of output for the pwd command across OS platforms. Please see the attached photo:

image

I believe this is actually important, as 'pwd' command is the first command that will be typed by learners throughout the whole episode. Adding the alert box, which reminds the instructor to briefly explain the reason for the variation, mitigates confusion for fresh learners.

That said, I don't think the box needs to be that wordy. I think adding a single line like: "Note that it may look slightly different across Windows, Mac and Linux platforms, as well as for different versions of Windows." will be totally fine, considering the time constraint.

Which part of the content does your suggestion apply to?

https://librarycarpentry.org/lc-shell/02-navigating-the-filesystem.html