Uh oh!
There was an error while loading. Please reload this page.
Add getting started pages - #616
Conversation
reardonj
left a comment
There was a problem hiding this comment.
One very minor issue but otherwise looks like a good start! We can probably find some more learning resources, but those can be added later.
Uh oh!
There was an error while loading. Please reload this page.
jducoeur
left a comment
There was a problem hiding this comment.
Minor suggestion: I'd adjust the order of the suggested books. I teach more or less these books all the time, and my suggested order is always:
- Creative Scala or Essential Scala first, since they are teaching the basics of the language.
- Then Scala with Cats, which builds on those to go deeper into category theory.
- Then FPiS, which is much deeper but way more effort. Putting FPiS too early can turn people off, because they get bogged down, not having enough background to appreciate it yet.
Caveat: that's based on FPiS v1. I haven't had time yet to work my way through v2, and it's possible that it really is that much more approachable, but I'm cautious.
reardonj
commented
Jul 25, 2026
It is still not a good intro to Scala in general. Never read 1st edition so can't compare there. |
reardonj
commented
Jul 25, 2026
FYI, I'm also building a full contributing guide off of this branch. I've reordered the books there. |
jducoeur
commented
Jul 25, 2026
While I think of it: we also might want to consider adding Essential Effects, which I've used to teach cats-effect a couple of times. And when Zainab's Functional Stream Processing is ready, we might want to consider that one here as well. (But that's for a later PR.) |
reardonj
commented
Jul 25, 2026
That link appears to be early access too? |
jducoeur
commented
Jul 25, 2026
Is it? Wild -- I think I've been teaching that book on and off for at least five years now. We might ask Adam about the status. |
Co-authored-by: Justin Reardon <me@jmreardon.com>
abby-ql
commented
Jul 27, 2026
thank you for the feedback! i have re ordered the book recommendations, and am happy to help add anything else |
reardonj
left a comment
There was a problem hiding this comment.
Sorry, a few other minor things I noticed while working on my PR. If you have time to fix those up we can get this merged. Otherwise I have a branch that builds on this that will be out for review in a few days.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Co-authored-by: Justin Reardon <me@jmreardon.com>
Updated the link to Typelevel Toolkit in the contribution guide.
abby-ql
commented
Jul 28, 2026
just fixed those |
Uh oh!
There was an error while loading. Please reload this page.
Fixes#590
Added two new pages under
src/community/:1.Start Contributing: outlines the typical contribution workflow across Typelevel projects, including issue selection (good-first-issue board), communication norms, PR process (included the AI policy), and Discord channels for help
2.Learning Resources: collects community recommended books, courses, and documentation for functional programming in Scala and key Typelevel libraries
Updated the community landing page template
about.template.htmlto include two additional cards, along with corresponding fragments incommunity/README.md. The new pages follow the existing community pagelayout and template structure.Used AI for formatting markdown & proofreading but I wrote the content itself, with help of past resources & recommendations found in various discord channels
example (learning resource page):

additional cards in community page: