summaryrefslogtreecommitdiff
path: root/web/philosophy.markdown
diff options
context:
space:
mode:
authorJasper Van der Jeugt <jaspervdj@gmail.com>2011-06-13 08:43:28 +0200
committerJasper Van der Jeugt <jaspervdj@gmail.com>2011-06-13 08:43:28 +0200
commitedeef66180f24e4254b512041bee617368fa1eba (patch)
treedf2b6c470dba9fda52a0d3b96fd569d2c74b2c48 /web/philosophy.markdown
parent893b366435739d073d2b6b9cafae868b5d361354 (diff)
downloadhakyll-edeef66180f24e4254b512041bee617368fa1eba.tar.gz
Remove examples from this repo
Diffstat (limited to 'web/philosophy.markdown')
-rw-r--r--web/philosophy.markdown28
1 files changed, 28 insertions, 0 deletions
diff --git a/web/philosophy.markdown b/web/philosophy.markdown
new file mode 100644
index 0000000..07a20c3
--- /dev/null
+++ b/web/philosophy.markdown
@@ -0,0 +1,28 @@
+---
+title: Philosophy
+---
+
+## Small-to-medium sites
+
+Hakyll was written to be used for small-to-medium sites. You can do some
+advanced things with it, but don't use it to build a big online shop.
+
+## Hakyll.hs
+
+It should be possible to put all configuration in one file, so data and
+configuration can be strictly separated. In addition, we think this file should
+never exceed a 100 lines of code.
+
+## High-level
+
+Hakyll tries to provide as many high-level functions as possible for common
+tasks, while the lower-level functions should also be accessible. If you think
+you're writing something that can be used for many sites, please send a patch,
+or your `hakyll.hs`, and we will see what we can do.
+
+## Well-documented
+
+A key to being easy-to-use is documentation. That's why we try to provide as
+many working examples as possible. If you ever create a site using hakyll,
+please consider open-sourcing it, as people might be able to learn from your
+code.