I very often wonder how many hopeful learners abandon technical beginner's guides because they have never used a command-line interface to install something.

@HXLNT "beginners" is super relative, it depends on the tech being demonstrated. It's hard to decide where to draw the line for "beginners", being able to use a mouse, touch typing? Using a browser or a terminal? Knowing how to write code? I think it's very project specific.

@neauoire Indeed! My thinking is more around intervening on those disappointing moments when early learners, who don't know what they don't know, are baffled by something cheerfully advertised as simple and for total beginners. (Web frameworks come to mind.) I think there's a lot of people who silently drop out in these moments, and likely in disproportionate measure those from underrepresented groups who have been told that technical topics are not "for" them in the first place.

@HXLNT I agree, these words should be removed altogether from documentation, it's impossible to predict where someone might be coming from.

Follow

@neauoire @HXLNT IMO they shouldn't just be removed, they should be *replaced* with "this guide/project/etc. assumes you already know the following things: ..."

· · Web · 0 · 0 · 0
Sign in to participate in the conversation
Pixietown

Small server part of the pixie.town infrastructure. Registration is closed.