Comments (6)
That works. Maybe we could replace chapter 2 with a discussion on how to run tests for the exercises. Perhaps follow-up from the getting-started guide by testing the project Euler problem, and add the diagonal example too.
from purescript-book.
That sounds like a good idea to me. It would likely make it less confusing for new learners as there aren't 3+ different 'Getting Started' guides on the Internet somewhere.
from purescript-book.
My preference would be to keep the one in the documentation repo and link to it from here, because it has the “next steps” at the bottom which ought to be useful for most people who have just installed purescript, whether or not they are new to FP, and whether or not they are working through this book.
from purescript-book.
I suppose a downside of that is that the book is no longer self-contained: if someone downloads the book in preparation for use on a flight or something, it’s going to be a bit of a letdown if the getting started instructions are elsewhere on the internet. I think this is why it’s perhaps not such a bad thing to have two different copies of it (not that we shouldn’t try to consolidate them, though).
from purescript-book.
keep the one in the documentation repo and link to it from [the book]
Would that mean the contents of Ch2 would just be a note and a link?
I think this is why it’s perhaps not such a bad thing to have two different copies
My concern with two copies is that they'll inevitably diverge, increase maintenance efforts, and be annoying for newcomers.
What is the downside of absorbing the docs repo version into the book? We could include a "Next Steps" section at the end of the chapter to either let users continue on with reading the book or explore another path. I think that would be the cleanest solution.
from purescript-book.
Perhaps, although in that case there's not much point in dedicating a whole chapter to just a note and a link; if we were just going to provide a link, then it would probably make more sense to remove the "Getting started" chapter and instead provide links at the end of the introduction and at the start of what is currently chapter 3. My hesitation about having this repo be the canonical place for it is that I don't think the getting started guide should be tied to any particular learning resource, and I also think that it should be in the purescript
org, and the core team should be approving any changes to it.
from purescript-book.
Related Issues (20)
- [Ch3] Indentation docs for `where` are wrong HOT 1
- :memo: Chapter 8 standard form label use HOT 1
- Chapter 11 HOT 1
- chapter 10 duplicated mapSetFoo instead of alternative
- chapter 10 double negation intended or typo? HOT 2
- Chapter 9, final exercise description improvement HOT 1
- Error in Handbook - Asynchronous Effects
- Update Book to PureScript `0.15.0` HOT 2
- Chapter 10: Confusion between `id` and `identity` functions HOT 4
- Getting Started scripts - not all lines are removed
- error ERR_REQUIRE_ESM following instructions in Getting Started HOT 1
- Example from book fails on freebsd HOT 3
- [CH4] A more concise implementation of fibTailRec. HOT 1
- Warning about not using latest spago.
- Swap of Ch4 and Ch5 incomplete HOT 1
- Ch6: Subclass/Superclass confusion for `Ord`/`Eq`
- Not clear that Exercise should include subdirectories
- Can you clarify this no peeking stuff? HOT 3
- Chapter 2, Pythagorean theorem
- Upgrade to the latest package set
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from purescript-book.