diff --git a/README.md b/README.md index a40e6a3..e66612c 100644 --- a/README.md +++ b/README.md @@ -42,7 +42,9 @@ See [the community guidelines](coc.md) to understand the conduct that is expecte ## DO NOT INSTALL HASKELL PLATFORM -Instead of following the instructions on Haskell.org, See [the install instructions](install.md) for how to get GHC & Cabal installed. +Instead of following the instructions on Haskell.org, get [Stack](haskellstack.org) to get GHC installed and to build your projects. + +If you don't know anything about Stack and would like an overview, check out this [comprehensive Stack video tutorial](https://www.youtube.com/watch?v=sRonIB8ZStw). ## Why not platform? diff --git a/install.md b/install.md index 6fa5426..6be7f09 100644 --- a/install.md +++ b/install.md @@ -1,3 +1,7 @@ +# These instructions are deprecated + +We now recommend you use [Stack](haskellstack.org) instead, but the instructions are preserved here for those that might want a minimal install. + # What are Haskell, GHC, and Cabal? Haskell is a programming language as laid out in the reports, most recent one diff --git a/tools.md b/tools.md new file mode 100644 index 0000000..d32c459 --- /dev/null +++ b/tools.md @@ -0,0 +1,34 @@ +# Tools + + +## Don't install or try to use ghc-mod if you're a beginner + +It's a bit fragile, more than a bit slow, and it's not worth the grief. + + +## Text Editors + +- Emacs + - [Install haskell-mode](https://github.com/bitemyapp/dotfiles/blob/master/.emacs#L31) + - [Install flycheck](https://github.com/bitemyapp/dotfiles/blob/master/.emacs#L29) + - Enable and configure Haskell, this can be just `(require 'haskell)` if you don't care about anything else. + - [Enable flycheck](https://github.com/bitemyapp/dotfiles/blob/master/.emacs#L97) + - Symlink Stack to `/usr/bin` or otherwise make sure flycheck can find it + - [dunzo.](https://twitter.com/bitemyapp/status/693621160571985920) + +- For Vim, we recommend [Stephen Diehl's instructions](http://www.stephendiehl.com/posts/vim_2016.html), though we'd recommend not bothering with ghc-mod if possible. + +- [Sublime Text](https://github.com/SublimeHaskell/SublimeHaskell) + +- [Atom](https://atom.io/packages/ide-haskell) + +- [IntelliJ](https://github.com/carymrobbins/intellij-haskforce) + +- Notepad++ has basic Haskell support built in. + +- gedit has basic Haskell support built in. + + +## Other + +- Haskell For Mac