stackage-server/templates/homepage.hamlet
2014-06-02 00:04:25 +02:00

88 lines
3.6 KiB
Plaintext

<div .container>
<h1>
Stackage is an infrastructure to create stable builds of complete package sets. Think “stable Hackage”.
<div .recommended-snapshots>
<h2>Recommended Snapshots
<ul .snapshots>
$forall (E.Value ident, E.Value title, E.Value uploaded, E.Value display, E.Value handle) <- stackages
<li>
<a href=@{StackageHomeR ident}>
#{title}
<div .how-it-works>
<h2>How Stackage Works
<div .row .media-top>
<div .span12>
<div .media>
<a .pull-left>
<img .media-object src=@{StaticR img_open_pr_png}>
<div .media-body>
<h4 .media-heading>
Submission
<div .media>
A contributor (either an author of a package, or a kind
soul) submits a patch to the Github repository. The pack
will be checked and then be merged in.
<div .media>
<a .pull-left>
<img .media-object src=@{StaticR img_jenkins_png}>
<div .media-body>
<h4 .media-heading>
Testing
<div .media>
The update is sent to a Jenkins build system at
<a href="http://jenkins.stackage.org/">
jenkins.stackage.org
in the cloud. There is a daily build which takes
about 8 hours.
<div .media>
<a .pull-left>
<img .media-object src=@{StaticR img_bump_png}>
<div .media-body>
<h4 .media-heading>
Notification
<div .media>
If a build failure occurs, the submitter is notified
via a Github issue and pinged via their
<code>@name</code>. Also, any authors of packages
which now fail to build will be notified.
<div .media>
<a .pull-left>
<img .media-object src=@{StaticR img_stackage_png}>
<div .media-body>
<h4 .media-heading>
Snapshot
<div .media>
If the build succeeds, a new snapshot is created. The new
snapshot is used by the community.
<div .contributing>
<h2>Contributing
<p>The steps are simple:
<ul>
<li>
Open the
<a href="https://github.com/fpco/stackage">
Stackage project on Github.
<li>Fork it.
<li>
<a href="https://github.com/fpco/stackage#get-your-package-included">
Add a line to the
<code>
Stackage.Config
module.
<li>Push to your fork.
<li>Open a pull request.
<p> Once you have submitted the pull request, a build will be
started. There is a dedicated jenkins server at this location:
<a href="http://jenkins.stackage.org/">
jenkins.stackage.org.
From here you can track the progress, status and results
of Stackage builds.
<div .businesses>
<h2>Stackage for businesses
<p> We're offering custom installations for businesses who want to
build their development platform upon Stackage. If you're
considering this for your business and want to find out more,
please email us at:
<a href="mailto:sales@fpcomplete.com">
sales@fpcomplete.com