carpentries / carpentries/instructor-training

Clarify whether the main goal of the Carpentries is, or isn't, skill-building

Open Beginner friendly
#1,916 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
189
Forks
301
Avg merge
2d 12h
Merged PRs (30d)
9

Description

### How could the content be improved?

https://carpentries.github.io/instructor-training/01-welcome.html states:

> The main goal of The Carpentries is _**not to teach specific skills**_, per se - although those are covered - but rather, to convey best practices that will enable researchers to be more productive and do better research.

But earlier the same page states that:

> The Carpentries is a global community of volunteer researchers, educators, and others oriented around improving basic computing and data skills for researchers

and most of https://carpentries.github.io/instructor-training/02-practice-learning.html is about how to help learners acquire new skills.

The suggestion here is to make clearer whether or not the main goal of the Carpentries is, or is not, to teach skills. (and if it is, that's not mutually exclusive from conveying best practices as well)

Contributor guide

Open the contributing guide

Research direction

Read the statements in 01-welcome.html alongside the discussion of skill acquisition in 02-practice-learning.html. Clarify the relationship between teaching skills and conveying best practices, then check both pages for consistent wording. Done means the Carpentries' main goal is understandable without suggesting that skill-building and best practices are mutually exclusive.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.