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

Add syllabus docs #369

Merged
merged 44 commits into from
Sep 19, 2022
Merged
Changes from 1 commit
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
66f0996
Add syllabus docs
ErikSchierboom Jul 6, 2022
c3f3e3a
Draft introduction to syllabus design document
kytrinyx Aug 15, 2022
153846f
Tweak syllabus docs
kytrinyx Aug 15, 2022
1929f87
Add stub documents for syllabus-specific 'getting started' documents
ErikSchierboom Aug 16, 2022
b592ee8
Add some notes about first exercise in syllabus
ErikSchierboom Aug 16, 2022
52f8678
Add some notes about next exercises in syllabus
ErikSchierboom Aug 16, 2022
7b93abc
Add some notes about expanding exercises in syllabus
ErikSchierboom Aug 16, 2022
c529f30
Expand on building out the syllabus
kytrinyx Aug 17, 2022
d25afba
Flesh out syllabus docs
kytrinyx Aug 17, 2022
3931c94
Tweak syllabus docs
kytrinyx Aug 17, 2022
d7ce02b
Add note about creating issues to syllabus docs
kytrinyx Aug 18, 2022
e3fbb33
Update syllabus docs
kytrinyx Aug 30, 2022
258b4a1
Tweak wording on syllabus docs
kytrinyx Aug 30, 2022
7bce1ea
Tweak wording on syllabus docs
kytrinyx Aug 30, 2022
fa06929
Update syllabus docs
kytrinyx Aug 30, 2022
d66d32f
Add specifics about where and how to ask for help to syllabus docs
kytrinyx Sep 7, 2022
b908c38
Add a bit more about cyclic dependencies
kytrinyx Sep 7, 2022
6010970
Add a note about non-idiomatic code in syllabus docs
kytrinyx Sep 7, 2022
0cf5db7
Add spaces around emdash for readability
kytrinyx Sep 7, 2022
9e25304
Adjust initial goal explanation of first concept exercise
kytrinyx Sep 7, 2022
9856904
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
8736500
Add. missing spacing in syllabus docs
kytrinyx Sep 19, 2022
34a2ee0
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
7cfd5cd
Appease markdown linter in syllabus docs
kytrinyx Sep 19, 2022
c204316
Use more common form of gerund in syllabus docs
kytrinyx Sep 19, 2022
0a729f2
Use more common form of gerund in syllabus docs
kytrinyx Sep 19, 2022
2ab1502
Appease markdown linter in syllabus docs
kytrinyx Sep 19, 2022
c9825e8
Fix typo in syllabus docs
kytrinyx Sep 19, 2022
043046a
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
97b89f5
Change team name in syllabus docs
kytrinyx Sep 19, 2022
99c7565
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
b7f119a
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
4176c45
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
ef643ec
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
6930e41
Improve formatting in syllabus docs
kytrinyx Sep 19, 2022
3622c8c
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
c48692a
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
1e2ac24
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
9f62c7c
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
434f48d
Clarify syllabus docs
kytrinyx Sep 19, 2022
d646107
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
4708642
Improve wording in syllabus docs
kytrinyx Sep 19, 2022
a228bf1
Remove unnecessary 'here' when linking from syllabus docs
kytrinyx Sep 19, 2022
d29d0d7
Add suggestion to syllabus docs
kytrinyx Sep 19, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Flesh out syllabus docs
Add section about selecting or coming up with stories
for concept exercises.
  • Loading branch information
kytrinyx committed Aug 17, 2022
commit d25afba678fa05bca7b10e134b39fe5c88416aa5
20 changes: 20 additions & 0 deletions building/tracks/syllabus/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,3 +93,23 @@ Handwave over some complexity in one so that you can get students familiar with
It's perfectly fine to say that something will be introduced in more depth later, and that for now the student just needs to understand this one bit.

Concepts are understood more deeply in stages and over time.

## Selecting stories
kytrinyx marked this conversation as resolved.
Show resolved Hide resolved

A concept exercise always has a story.

If you're forking an exercise from another track, then the exercise will already have a story.
In that case, you're all set.

To see if there are any existing stories you can use or exercises you can fork, check out the [list of stories](docs/building/tracks/stories).

If you have a concept but no story then our recommendation is to write a small, simple code example that uses the concept that you're introducing.
Then reverse engineer a story onto the code.
Keep the story stupidly simple.
It doesn't have to be good fiction.
It doesn't need a strong plot or character development.
kytrinyx marked this conversation as resolved.
Show resolved Hide resolved

Bounce ideas for stories with the Exercism team.
We have a lot of experience coming up with suitable stories.

Once you have a story you will likely need to tweak the code a bit to get it to fit the story.