From 615eccb10d76abadfe6c228e3b4096198567ac67 Mon Sep 17 00:00:00 2001 From: Gabriel Gonzalez Date: Thu, 13 Dec 2018 06:44:33 -0800 Subject: [PATCH] Expand main page with high-level reasons to adopt Dhall (#754) This adds four new sections to the page after the live demo which highlight the common themes that I notice people use when communicating the value of Dhall to others on social media: * The first section emphasizes the element of delight in using the language for people who are into elegance and quality * The second section focuses on more pragmatic people who are sick of YAML and just want a reasonable alternative that they can convince their manager to adopt * The third section appeals to the LangSec crowd that wants an uncompromising and secure foundation for what they are buliding * The last section targeted at the skeptic who thinks that Dhall is an ivory tower language not suited for real-world problems. The second crowd (YAML emigrants) is the audience that I'm targeting the most strongly at the moment, but I didn't want to lead with a negative reason adopt by focusing on the limitations of YAML, so I put the section on delight first so that we could start with a more positive tone. --- README.md | 4 +- default.nix | 2 +- dhall-bash/README.md | 4 ++ dhall-json/README.md | 4 ++ dhall-try/index.html | 92 ++++++++++++++++++++++++++++++++++++++++++-- dhall/README.md | 4 ++ nix/shared.nix | 10 ++--- 7 files changed, 109 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 22b937c..0e50f4b 100644 --- a/README.md +++ b/README.md @@ -104,12 +104,12 @@ Building the website from source is currently only supported for Nix on Linux. You can build the static assets by running: ```bash -$ nix-build --attr try-dhall-static +$ nix-build --attr try-dhall ``` ... then open `./result/index.html` in your browser. -You can also download archive containing the pre-built website from CI using +You can also download an archive containing the pre-built website from CI using this link: * [try-dhall.tar.bz2](http://hydra.dhall-lang.org/job/dhall-haskell/master/tarball-try-dhall/latest/download-by-type/file/binary-dist) diff --git a/default.nix b/default.nix index 8c69b97..e7962a7 100644 --- a/default.nix +++ b/default.nix @@ -6,5 +6,5 @@ let in { inherit (shared) dhall dhall-bash dhall-json dhall-text; - inherit (shared_ghcjs) dhall-try try-dhall-static; + inherit (shared_ghcjs) dhall-try try-dhall; } diff --git a/dhall-bash/README.md b/dhall-bash/README.md index 239d454..6505bbe 100644 --- a/dhall-bash/README.md +++ b/dhall-bash/README.md @@ -4,6 +4,10 @@ For installation or development instructions, see: * [`dhall-haskell` - `README`](https://github.com/dhall-lang/dhall-haskell/blob/master/README.md) +Full documentation here: + +* [`dhall-bash` instructions](https://hackage.haskell.org/package/dhall-bash/docs/Dhall-Bash.html) + ## Introduction This `dhall-bash` package provides a Dhall to Bash compiler so that you can diff --git a/dhall-json/README.md b/dhall-json/README.md index 41c8c77..e27c4cf 100644 --- a/dhall-json/README.md +++ b/dhall-json/README.md @@ -4,6 +4,10 @@ For installation or development instructions, see: * [`dhall-haskell` - `README`](https://github.com/dhall-lang/dhall-haskell/blob/master/README.md) +Full documentation here: + +* [`dhall-json` instructions](https://hackage.haskell.org/package/dhall-json/docs/Dhall-JSON.html) + ## Introduction This `dhall-json` package provides a Dhall to JSON compiler and a Dhall to YAML diff --git a/dhall-try/index.html b/dhall-try/index.html index 2181fbd..753b27e 100644 --- a/dhall-try/index.html +++ b/dhall-try/index.html @@ -41,6 +41,7 @@ .navbar { margin-bottom: 20px; + border-bottom: 1px solid black; }; @@ -54,7 +55,7 @@ -