You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The lessons are a bit spread out and are in several distinct formats. It would benefit new users and contributors if the barrier to entry was lower. This ticket is a nebulous list of "nice-to-haves" I jotted down after my first impression
It would be good if the following were supported:
A single html overview with a table of contents linking directly to each individual lesson
standalone markdown files that can be read / edited / rendered outside a browser context (has important accessibility benefits for all users)
Use of html / markdown everywhere
automatic regeneration of PDFs if they're worth keeping in the repository
1,2, and 4 should be relatively straightforward; 3 is achievable with some manual labour:
This could be a trivial list html file with a manually curated TOC
standalone markdown files are supported by reveal.js e.g.:
A final nice-to-have might be to automatically deploy a github pages asset so users don't even have to clone the repo to access the lecture material; this would certainly "ease" users in - though they'll likely want to clone later to complete the exercises
The text was updated successfully, but these errors were encountered:
The lessons are a bit spread out and are in several distinct formats. It would benefit new users and contributors if the barrier to entry was lower. This ticket is a nebulous list of "nice-to-haves" I jotted down after my first impression
It would be good if the following were supported:
1,2, and 4 should be relatively straightforward; 3 is achievable with some manual labour:
A final nice-to-have might be to automatically deploy a github pages asset so users don't even have to clone the repo to access the lecture material; this would certainly "ease" users in - though they'll likely want to clone later to complete the exercises
The text was updated successfully, but these errors were encountered: