Repository navigation
"Getting Started" directions don't work on OSX #396
Description
Activity
I think it would go something like this:
- Create a branch, call it
follow-alongor something. - Allow GH actions to push...I haven't done this personally, but I know it's a thing.
- 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
- Update the instructions in the book to instead check out the branch that's totally ready for your readers to play with!
Reacted by Joe Gomain Hoyes and Søren Høyer- Create a branch, call it
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.
Thanks for the feedback.
For some context, we swapped to
perldue to mac issues withsed. See #194 and #196.
But those changes were made before it was possible to execute arbitrary .purs standalone scripts withspago, so perhaps we're due for a rewrite where we eat our own dogfood.An action to push to a
follow-alongbranch also sounds good. I probably won't get around to implementing that myself anytime soon, but will accept a PR.Reacted by gemmaro, Patrick Toy and giladwoI think it would go something like this:
- Create a branch, call it
follow-alongor something. - Allow GH actions to push...I haven't done this personally, but I know it's a thing.
- 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
- 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 markdownlintkept 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
- Create a branch, call it
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.
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?
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.
This is not a show-stopper for me but I'm a little blown away that you have two scripts that you instruct users to run after cloning this repo to follow along, and they are a little crazy, all things considered.
Here's my list of complaints:
"ANCHOR"only appears in the repo in the lines that should be deleted inexercisesand that script.sedis still a better choice for all these tasks you could dosed -i.nuke && find ./exercises -type f -name "*.nuke" -deleteor something like that.I've already spent more time complaining about this than it would take to fix it :( Sorry about that.
Forget all that, here's an actual suggestion that I might contribute:
When changes are merged into master, run a GH action that applies the instructions and pushes them to a branch that you can point users at. This is simple, would run in a controlled environment (linux, with gnu find/sed and perl installed), and would lower the bar that much more for your readers.