@@ -0,0 +1,28 @@
1+---
2+title: Philosophy
3+---
4+
5+## Small-to-medium sites
6+
7+Hakyll was written to be used for small-to-medium sites. You can do some
8+advanced things with it, but don't use it to build a big online shop.
9+
10+## Hakyll.hs
11+
12+It should be possible to put all configuration in one file, so data and
13+configuration can be strictly separated. In addition, we think this file should
14+never exceed a 100 lines of code.
15+
16+## High-level
17+
18+Hakyll tries to provide as many high-level functions as possible for common
19+tasks, while the lower-level functions should also be accessible. If you think
20+you're writing something that can be used for many sites, please send a patch,
21+our your `hakyll.hs`, and we will see what we can do.
22+
23+## Well-documented
24+
25+A key to being easy-to-use is documentation. That's why we try to provide as
26+many working examples as possible. If you ever create a site using hakyll,
27+please consider open-sourcing it, as people might be able to learn from your
28+code.