1. happs intro
2. the missing happs documentation
3. getting started with happs
4. prerequisites
5. cabal install me
6. main
7. url handling
8. templates
9. stringtemplate basics
10. debugging
11. form data: get and post
12. form data: file uploads
13. cookies
14. introduction to macid
15. using macid safely
16. macid dummy data
17. macid updates and queries
18. changing the data model
19. macid stress test
20. limitations of macid
21. foreign characters
22. cron jobs
23. thanks
24. appendix (floundering in ghci)

The missing HAppS documentation, and what to do about it

Unfortunately, the documentation for HAppS is cringeworthy. So bad that honestly I wouldn't know where to start to fix it.

Instead of tackling the documentation probablem directly by doing the obvious thing and writing patches for haddock, I decided to create an easy-to-install demo project that included clear step-by-step instructions for getting from zero to final product. I figure what the HAppS ecosystem needs most, after better documentation, is the opportunity for developers to make real money doing real work by leveraging this technology. So the demo project is a job board. It's full of dummy data at the moment, but feel free to post real jobs here if you have them on offer. (But cc the happs googlegroup as well!   :)   )

By the way, I am currently available for haskell, HAppS, and startup consulting.

My hope is that that this material will tempt people to try HAppS out. Both curious developers, and investors that want a non-trivial website and are willing to gamble on a new technology if it can get the job better, and most importantly, faster. With enough users, I believe the documentation and other "batteries not included" issues with HAppS will matter less and less, as the gaps get plugged in a gradual way.

Let's get started.