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.
This commit is contained in:
Gabriel Gonzalez
GitHub
parent
dfd9822e77
commit
615eccb10d
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
}
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -41,6 +41,7 @@
|
|||
|
||||
.navbar {
|
||||
margin-bottom: 20px;
|
||||
border-bottom: 1px solid black;
|
||||
};
|
||||
</style>
|
||||
<link rel="stylesheet" href="./css/codemirror.css">
|
||||
|
|
@ -54,7 +55,7 @@
|
|||
<script language="javascript" src="./js/js-yaml.min.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<nav class="navbar navbar-expand-lg navbar-light bg-light">
|
||||
<nav class="navbar sticky-top navbar-expand-lg navbar-light bg-light">
|
||||
<a class="navbar-left" href="https://dhall-lang.org"><img src="./img/dhall-small-logo.png" height="31px"></a>
|
||||
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
|
|
@ -141,10 +142,10 @@
|
|||
<a class="nav-link" href="https://github.com/dhall-lang/dhall-lang/blob/master/README.md"><img src = "./img/github-logo.png" height="25px"></a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a class="nav-link" href="https://twitter.com/dhall_lang"><img src = "./img/twitter-logo.png" height="32px"></a>
|
||||
<a class="nav-link" href="https://twitter.com/dhall_lang"><img src = "./img/twitter-logo.svg" height="32px"></a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a class="nav-link" href="https://stackoverflow.com/questions/tagged/dhall"><img src = "./img/stack-overflow-logo.png" height="32px"></a>
|
||||
<a class="nav-link" href="https://stackoverflow.com/questions/tagged/dhall"><img src = "./img/stack-overflow-logo.svg" height="32px"></a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
|
@ -190,6 +191,47 @@
|
|||
<textarea id="dhall-output"></textarea>
|
||||
</div>
|
||||
</div>
|
||||
<div class="container jumbotron" style="background-color: #c5eccf">
|
||||
<h1 class="display-4">Human-friendly</h1>
|
||||
<p class="lead">Dhall supports comments, multi-line string literals and
|
||||
string interpolation with non-technical users in mind.</p>
|
||||
<textarea id="highlight0"></textarea>
|
||||
<p>You can also automatically remove all indirection in any Dhall code,
|
||||
converting the file to a logic-free normal form for non-programmers to
|
||||
understand.</p>
|
||||
<a href="https://github.com/dhall-lang/dhall-lang/wiki/Programmable-configuration-files"class="btn btn-lg btn-outline-dark bg-light">Learn More</a>
|
||||
</div>
|
||||
<div class="container jumbotron" style="background-color: #fbf3c8">
|
||||
<h1 class="display-4">Tired of YAML?</h1>
|
||||
<p class="lead">Dhall eliminates the YAML quirks that software engineers
|
||||
dread. The language standard learns from the mistakes of the past.</p>
|
||||
<textarea id="highlight1"></textarea>
|
||||
<p>You can also generate either YAML or JSON from Dhall configuration
|
||||
files using tiny statically-linked binaries. Dhall can cheaply fit right
|
||||
in with your existing tools and infrastructure.</p>
|
||||
<a href="https://github.com/dhall-lang/dhall-lang/wiki/Getting-started%3A-Generate-JSON-or-YAML" class="btn btn-lg btn-outline-dark bg-light">Get Started</a>
|
||||
</div>
|
||||
<div class="container jumbotron" style="background-color: #fbecf1">
|
||||
<h1 class="display-4">Turing-completeness is not a feature</h1>
|
||||
<p class="lead">Dhall is programmable, but <b>NOT</b> Turing-complete.</p>
|
||||
<hr class="my-4">
|
||||
<p>We take language security seriously so that your Dhall programs
|
||||
never fail, hang, crash, leak secrets, or compromise your system.</p>
|
||||
<p>You can safely import and evaluate untrusted Dhall code, even code
|
||||
authored by malicious users.</p>
|
||||
<a href="https://github.com/dhall-lang/dhall-lang/wiki/Safety-guarantees"class="btn btn-lg btn-outline-dark bg-light">Learn More</a>
|
||||
</div>
|
||||
<div class="container jumbotron" style="background-color: #cfebfb">
|
||||
<h1 class="display-4">Tough on messes</h1>
|
||||
<p class="lead">Dhall is built for large and weird configuration
|
||||
schemas.</p>
|
||||
<hr class="my-4">
|
||||
<p>Don't let the types fool you: Dhall can integrate with messy APIs and
|
||||
tools. You can even convert Dhall to ad-hoc and non-standard
|
||||
configuration file formats.</p>
|
||||
<a href="https://github.com/dhall-lang/dhall-nethack" class="btn btn-lg btn-outline-dark bg-light">See an Example</a>
|
||||
</div>
|
||||
<hr class="my-4">
|
||||
<p class="text-center">This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.</p>
|
||||
</body>
|
||||
<script>
|
||||
|
|
@ -347,6 +389,50 @@ in {- Try generating 20 users instead of 10 -}
|
|||
};
|
||||
|
||||
input.setValue(example0);
|
||||
|
||||
|
||||
let highlight0 = document.getElementById("highlight0");
|
||||
|
||||
h0 = CodeMirror.fromTextArea(highlight0, {
|
||||
lineNumbers: true,
|
||||
mode: "haskell",
|
||||
readOnly: true
|
||||
});
|
||||
|
||||
h0.setValue(`let input =
|
||||
{ relative = "daughter"
|
||||
, movies = [ "Boss Baby", "Frozen", "Moana" ]
|
||||
}
|
||||
|
||||
let concatSep = https://prelude.dhall-lang.org/Text/concatSep
|
||||
|
||||
-- Dhall strips leading indentation for you
|
||||
in ''
|
||||
My \${input.relative} loves to watch \${concatSep ", " input.movies}
|
||||
|
||||
How about you?
|
||||
''`);
|
||||
|
||||
let highlight1 = document.getElementById("highlight1");
|
||||
|
||||
h1 = CodeMirror.fromTextArea(highlight1, {
|
||||
lineNumbers: true,
|
||||
mode: "haskell",
|
||||
readOnly: true
|
||||
});
|
||||
|
||||
h1.setValue(`{ -- Unlike YAML, Dhall does not accept YES|NO|ON|OFF
|
||||
validDhallBools = [ True, False ]
|
||||
, someNumbers = [ 1
|
||||
,
|
||||
-- Dhall is not indentation-sensitive
|
||||
2, 3 ]
|
||||
-- Field names that conflict with reserved identifiers must be quoted
|
||||
, \`True\` = True
|
||||
, version = "9.3" {- Strings must be quoted
|
||||
|
||||
All Dhall literals have unambiguous types -}
|
||||
}`);
|
||||
</script>
|
||||
<script language="javascript" src="./js/all.min.js" defer></script>
|
||||
</html>
|
||||
|
|
|
|||
|
|
@ -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` instructions](https://hackage.haskell.org/package/dhall/docs/Dhall-Tutorial.html)
|
||||
|
||||
## Introduction
|
||||
|
||||
Dhall is a programmable configuration language that is not Turing-complete
|
||||
|
|
|
|||
|
|
@ -229,7 +229,7 @@ let
|
|||
|
||||
twitterBootstrap = pkgsNew.callPackage ./twitterBootstrap.nix { };
|
||||
|
||||
try-dhall-static = pkgsNew.runCommand "try-dhall-static" {} ''
|
||||
try-dhall = pkgsNew.runCommand "try-dhall" {} ''
|
||||
${pkgsNew.coreutils}/bin/mkdir $out
|
||||
${pkgsNew.coreutils}/bin/mkdir $out/{css,img,js}
|
||||
${pkgsNew.coreutils}/bin/cp ${../dhall-try/index.html} $out/index.html
|
||||
|
|
@ -254,15 +254,15 @@ let
|
|||
${pkgsNew.coreutils}/bin/ln --symbolic ${pkgsNew.logo.kubernetes} $out/img/kubernetes-logo.svg
|
||||
${pkgsNew.coreutils}/bin/ln --symbolic ${pkgsNew.logo.json} $out/img/json-logo.svg
|
||||
${pkgsNew.coreutils}/bin/ln --symbolic ${pkgsNew.logo.nix} $out/img/nix-logo.png
|
||||
${pkgsNew.coreutils}/bin/ln --symbolic ${pkgsNew.logo.stackOverflow} $out/img/stack-overflow-logo.png
|
||||
${pkgsNew.coreutils}/bin/ln --symbolic '${pkgsNew.logo.twitter}/Twitter Logos/Twitter Logos/Twitter_Logo_Blue/Twitter_Logo_Blue.svg' $out/img/twitter-logo.png
|
||||
${pkgsNew.coreutils}/bin/ln --symbolic ${pkgsNew.logo.stackOverflow} $out/img/stack-overflow-logo.svg
|
||||
${pkgsNew.coreutils}/bin/ln --symbolic '${pkgsNew.logo.twitter}/Twitter Logos/Twitter Logos/Twitter_Logo_Blue/Twitter_Logo_Blue.svg' $out/img/twitter-logo.svg
|
||||
${pkgsNew.coreutils}/bin/ln --symbolic ${pkgsNew.logo.yaml} $out/img/yaml-logo.png
|
||||
${pkgsNew.coreutils}/bin/mkdir $out/nix-support
|
||||
${pkgsNew.coreutils}/bin/echo "doc none $out/index.html" > $out/nix-support/hydra-build-products
|
||||
'';
|
||||
|
||||
tarball-try-dhall = pkgsStaticLinux.releaseTools.binaryTarball rec {
|
||||
src = pkgsNew.try-dhall-static;
|
||||
src = pkgsNew.try-dhall;
|
||||
|
||||
installPhase = ''
|
||||
releaseName=try-dhall
|
||||
|
|
@ -531,7 +531,7 @@ in
|
|||
tarball-dhall-json = makeTarball "dhall-json";
|
||||
tarball-dhall-text = makeTarball "dhall-text";
|
||||
|
||||
inherit (pkgs) tarball-try-dhall try-dhall-server try-dhall-static;
|
||||
inherit (pkgs) tarball-try-dhall try-dhall-server try-dhall;
|
||||
|
||||
inherit (pkgs.haskell.packages."${compiler}") dhall dhall-bash dhall-json dhall-text dhall-try;
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue