Update 'Getting Started' guide to include new installation methods#299
Update 'Getting Started' guide to include new installation methods#299mbbx6spp wants to merge 1 commit intopurescript:masterfrom
Conversation
|
Related to purescript/purescript.github.io#141 which I will be modifying momentarily to account for this change. |
|
I’m not sure about this one; personally, I’m most concerned about the users who don’t know or care what all of these different install options are, and I definitely don’t want to overload them with information they don’t know what to do with and present them with choices they aren’t equipped to make. Of course this information should be recorded somewhere, but the purpose of this guide is to help people get a basic setup working with absolutely minimal fuss, so I am not sure here is the correct place. There’s INSTALL.md in the compiler right now, which covers alternative installation methods to some extent, but that is admittedly very easy to overlook. |
|
@hdgarrood would it make sense for me to relocate these new install methods in the INSTALL.md of the compiler and link to there from this document for those interested? |
|
Yes, that sounds good to me. |
… and link to Spago (#141) * Add instructions on how to install purescript from Homebrew and Nix Co-Authored-By: Nathan Faubion <natefaubion@users.noreply.github.com> * Remove 'and Yarn' from recommendation on how to manage JS dependencies * Remove Homebrew and Nix instructions from front page per purescript/documentation#299 Co-authored-by: Susan Potter <sp721@ntrs.com> Co-authored-by: Nathan Faubion <natefaubion@users.noreply.github.com>
| #### Using Nix | ||
|
|
||
| You'll need [Nix](https://nixos.org/nix/) installed with a recent version of `nixpkgs` (19.09): | ||
|
|
||
| nix-env -i purescript |
There was a problem hiding this comment.
May I suggest also adding easy-purescript-nix? Just starting learning PureScript, and it has everything a beginner needs (or any PS dev for that matter) - plus nothing is broken as it pins nixpkgs. This stackoverflow thread is a perfect summary how confusing the PS eco-system for a new-comer, adding NixOS to mix as well.
There was a problem hiding this comment.
It may be worth mentioning it not just in INSTALL.md but somewhere here in this documentation repo, because easy-purescript-repo sets up a(n almost) complete development environment with the "recommended" utilities.
|
This also relates to #323 |
|
We're going to use INSTALL.md in the compiler repo to discuss other installation methods, so I'll close this. As far as I can tell, the compiler's INSTALL.md covers all of the mentioned resources apart from Nix (which I am open to taking a PR for). |
4 participants
Updates 'Getting Started' guide with different subsections for existing and new methods of installation, including: