-
Notifications
You must be signed in to change notification settings - Fork 192
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
"Getting Started" directions don't work on OSX #396
Comments
I think it would go something like this:
|
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 An action to push to a |
I can confirm that this works fine, and is a decent solution for us Windows users. :-) There's a small typo where it says
# - 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 |
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 inexercises
and that script.sed
is still a better choice for all these tasks you could dosed -i.nuke && find ./exercises -type f -name "*.nuke" -delete
or 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.
The text was updated successfully, but these errors were encountered: