Table of Contents for 'Purescript: Jordan's Reference'


#1

My repo now has a Table of Contents that is automatically generated via an in-repo project.

See the file here: https://github.com/JordanMartinez/purescript-jordans-reference/blob/ps-0.12.x-v0.11.2/table-of-contents.md

Source code (along with pre-req explanations) is here: https://github.com/JordanMartinez/purescript-jordans-reference/tree/latestRelease/22-Projects/src/11-Table-of-Contents

Feel free to tell me where my code is terrible. I’m still learning and would appreciate suggestions.


#2

This is a huge resource! Thanks for putting in the time and effort to produce it.

Once small criticism at first glance is you tend to use “instance” a lot when referring to values of a type (eg https://github.com/JordanMartinez/purescript-jordans-reference/blob/development/11-Syntax/03-Type-Level-Programming-Syntax/src/01-An-Overview-of-Terms-and-Concepts.md#types-reexamined). I think this is a bit of an OOPism, and a little overloaded since we have instances in PS and these aren’t them :stuck_out_tongue_winking_eye:. “An instance of type Foo” can be phrased simply as “a value of type Foo”.


#3

Thanks!

Once small criticism at first glance is you tend to use “instance” a lot when referring to values of a type

Ah, good point! I’ll open an issue for it.


#4

Amazing stuff!
I see it as a basis for a future book (“PureScript by Example” vol.2)…

Keep going!..


#5

Just wanted to let you know that I’ve updated my repo to account for your critique. Atom’s “Project Find and Replace” helped me to complete this quicker than it would have taken otherwise.


#6

Thanks!

Not a bad suggestion, but if it is turned into a book, I would probably call it by some other name. Who knows whether Phil will update his book again in the future?