"Getting Started" directions don't work on OSX about purescript-book HOT 7 OPEN

Thanks for the feedback.

For some context, we swapped to perl due to mac issues with sed. See #194 and #196.
But those changes were made before it was possible to execute arbitrary .purs standalone scripts with spago, so perhaps we're due for a rewrite where we eat our own dogfood.

An action to push to a follow-along branch also sounds good. I probably won't get around to implementing that myself anytime soon, but will accept a PR.

from purescript-book.

I think it would go something like this:

1. Create a branch, call it follow-along or something.
2. Allow GH actions to push...I haven't done this personally, but I know it's a thing.
3. Add an action that's something like this:

   name: Update follow-along branch
   on:
     push:
       branches: [master]
     pull_request:
   jobs:
     update:
       runs-on: ubuntu-latest
       steps:
         - Check it out 
           uses: actions/checkout@v2
         - name: Update the thing
           run: |
             ./scripts/resetSolutions.sh
             ./scripts/removeAnchors.sh
             git add --all
             git commit --message "Some really sweet message here"
             git push origin HEAD:follow-along

4. Update the instructions in the book to instead check out the branch that's totally ready for your readers to play with!

from purescript-book.

If I get motivated this weekend I will try to get all the config steps together, test on a non-fork (I guess? actions are weird), and wrap it up in a PR.

from purescript-book.

I think it would go something like this:

1. Create a branch, call it follow-along or something.
2. Allow GH actions to push...I haven't done this personally, but I know it's a thing.
3. Add an action that's something like this:

   name: Update follow-along branch
   on:
     push:
       branches: [master]
     pull_request:
   jobs:
     update:
       runs-on: ubuntu-latest
       steps:
         - Check it out 
           uses: actions/checkout@v2
         - name: Update the thing
           run: |
             ./scripts/resetSolutions.sh
             ./scripts/removeAnchors.sh
             git add --all
             git commit --message "Some really sweet message here"
             git push origin HEAD:follow-along

4. Update the instructions in the book to instead check out the branch that's totally ready for your readers to play with!

I can confirm that this works fine, and is a decent solution for us Windows users. :-)

There's a small typo where it says - Check it out - it should of course be - name: Check it out.

npx markdownlint kept failing, so in the generated tests.yml I commented out the last 2 lines to disable it for now:

#      - name: Run Markdown lint
#        run: npx markdownlint **/*.md

Depending on how your setup you might have to set github username and email

- name: setup git config
   run: |
     git config user.name "GitHub Actions Bot"
     git config user.email "<>"

And remember to allow "Read and write permissions" under Settings -> Actions -> General -> Workflow permissions

from purescript-book.

Just FYI. There's not really anyone maintaining this work anymore. So, this won't be fixed unless someone volunteers to do the above suggestion.

from purescript-book.

Just FYI. There's not really anyone maintaining this work anymore. So, this won't be fixed unless someone volunteers to do the above suggestion.

If the PureScript book is not up to date and actively maintained, how are people supposed to learn the language?

from purescript-book.

Just FYI. There's not really anyone maintaining this work anymore. So, this won't be fixed unless someone volunteers to do the above suggestion.

If the PureScript book is not up to date and actively maintained, how are people supposed to learn the language?

To clarify, just because no one is maintaining this resource doesn't mean it's still not useful. I'm not sure where and how much it's outdated. (Miles was the last one to seriously invest effort into updating and maintaining this resource. I just push "obvious" changes that benefit this, but I don't invest time into it otherwise because I'm using my time to benefit the community in other ways.) The concepts it teaches are likely still correct, but the code/syntax it uses may not be what one uses now.

I think you may be better off reading Functional Programming Made Easier (see it's announcement). It's not free, but a few people have praised it for how well it helped them get past the FP learning curve. If that work was written for an older version of PureScript, I would learn PureScript on that older version, and then read through the corresponding migration guide. That should get you up-to-speed.

Another resource is one I've written when I was learning PureScript: PureScript: Jordan's Reference. It's probably the most up-to-date resource we have, but it's learning approach may not be your cup of tea. It also doesn't have any exercises. But in general, if you're looking for documentation on X, you should likely look there first as I probably have something on it.

If you want to better understand monad transformers, I did a talk on that: https://github.com/JordanMartinez/pure-conf-talk/

Lastly, most people who need help usually ask questions and get answers from people on the core team or those who have been involved in the community for a while via the Discord chatroom or Discourse.

So, it's usually a combo of reading one of the above resources, watching a video I link to in my repo, and asking people for help on specific issues you run into.

from purescript-book.