Skip to content

Commit 15a5c48

Browse files
committed
Improve the "Why Stack?" content (fixes #3206)
Pinging @ndmitchell for feedback on this updated content.
1 parent b31c8b5 commit 15a5c48

File tree

1 file changed

+30
-20
lines changed

1 file changed

+30
-20
lines changed

doc/README.md

Lines changed: 30 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -154,23 +154,33 @@ This repository also contains a complete [user guide to using stack
154154
* When using Stack Overflow, please use [the haskell-stack
155155
tag](http://stackoverflow.com/questions/tagged/haskell-stack).
156156

157-
#### Why stack?
158-
159-
stack is a project of the [Commercial Haskell](http://commercialhaskell.com/)
160-
group, spearheaded by [FP Complete](https://www.fpcomplete.com/). It is
161-
designed to answer the needs of commercial Haskell users, hobbyist Haskellers,
162-
and individuals and companies thinking about starting to use Haskell. It is
163-
intended to be easy to use for newcomers, while providing the customizability
164-
and power experienced developers need.
165-
166-
While stack itself has been around since June of 2015, it is based on codebases
167-
used by FP Complete for its corporate customers and internally for years prior.
168-
stack is a refresh of that codebase combined with other open source efforts
169-
like [stackage-cli](https://github.com/fpco/stackage-cli) to meet the needs of
170-
users everywhere.
171-
172-
A large impetus for the work on stack was a [large survey of people interested
173-
in
174-
Haskell](https://www.fpcomplete.com/blog/2015/05/thousand-user-haskell-survey),
175-
which rated build issues as a major concern. The stack team hopes that stack
176-
can address these concerns.
157+
#### Why Stack?
158+
159+
Stack is a build tool for Haskell designed to answer the needs of
160+
Haskell users new and experienced alike. It has a strong focus on
161+
reproducible build plans, multi-package projects, and a consistent,
162+
easy-to-learn interface, while providing the customizability and
163+
power experienced developers need. As a build tool, Stack does not
164+
stand alone. It is built on the great work provided by:
165+
166+
* The __Glasgow Haskell Compiler__ (GHC), the premiere Haskell
167+
compiler. Stack will manage your GHC installations and automatically
168+
select the appropriate compiler version for your project.
169+
* The __Cabal build system__, a specification for defining Haskell
170+
packages, together with a library for performing builds.
171+
* The __Hackage package repository__, providing more than ten thousand
172+
open source libraries and applications to help you get your work
173+
done.
174+
* The __Stackage package collection__, a curated set of packages from
175+
Hackage which are regularly tested for compatibility. Stack defaults
176+
to using Stackage package sets to avoid dependency problems.
177+
178+
Stack is provided by a team of volunteers and companies under the
179+
auspices of the [Commercial Haskell](http://commercialhaskell.com/)
180+
group. The project was spearheaded by
181+
[FP Complete](https://www.fpcomplete.com/) to answer the needs of
182+
commercial Haskell users, and has since become a thriving open source
183+
project meeting the needs of Haskell users of all stripes.
184+
185+
If you'd like to get involved with Stack, check out the
186+
[newcomers label on the Github issue tracker](https://github.com/commercialhaskell/stack/issues?q=is%3Aopen+is%3Aissue+label%3Anewcomer).

0 commit comments

Comments
 (0)