Skip to content

Markdown files generated from Learning Lab courses. X- means migrated, Z- means won't migrate. (Cloned from /githublearn)

Notifications You must be signed in to change notification settings

githubpartners/learning-lab-markdown

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Markdown files generated from Learning Lab courses

X- means migrated, Z- means won't migrate.

How to regenerate these files

Note the renames on X- and Z- files.

  1. https://github.com/settings/tokens
  2. Make a PAT with repo permissions
  3. script/clone-course-repos
  4. npm ci
  5. script/write-markdown-files.mjs

heiskr's tips to migrating courses from Learning Lab Markdown

Start with these:

Learning Lab courses have varying degrees of content depth, relevance, and up-to-date-ness. We don't want these courses to have a high maintenance requirements, and we know learners don't like long courses.

So, in a word: EDIT.

  • See a nice long body of copy for the learner to read? Cut it down to a sentence or two and then link to GitHub Docs articles instead. Docs articles are more likely to stay up-to-date.
  • Cut out administrative steps, use gh cli instead. (Close issue, open PR, approve PR... if that's not the objective, automate it.)
  • Combine steps down. For example, add upload action, read text/close issue, add download action, read text/close issue... can all be one step instead.
  • Cut steps that are tangent to the learning objectives. Its fun to show off lots of features, but that can be really overwhelming and more to maintain.
  • Where possible, update courses to be code-language agnostic. Markdown is the universal language of GitHub.
  • If you really can't get it down to three to five steps, consider splitting the course into smaller courses.

About

Markdown files generated from Learning Lab courses. X- means migrated, Z- means won't migrate. (Cloned from /githublearn)

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published