PureScript: Jordan’s Reference, an in-depth beginner-oriented guide to learning PureScript from foundations-up.
This change comes with the following advantages:
- you can now search the entire project
- you can easily navigate around the content via the ToC and via left/right arrows
- it comes in multiple themes
- Since PureScript doesn’t have a syntax highlighter via
highlight.js, I’ve switched the highlighting language to
haskell. It gets you 90% but some things still won’t be highlighted correctly
- Folders are still nested at various points. This won’t change, so that people who have
git cloned it locally can still follow along in their own copy of the code
- Due to the nesting folders issue above, the sidebar’s ToC should be extended horizontally. It makes it easier to see where in the nesting you are.
Things I haven’t figured out:
- How can I limit the problems that arise when making breaking changes (e.g. rename/delete a file)? For example, a reader gets half-way through reading
Foo.htmland then sleeps. I delete the file and make a new release. The reader wakes up, and suddenly finds that
Foo.htmlleads to a 404, not a page.
- Should this have it’s own domain name? I’d prefer not to maintain another thing.