Does the main README need to be an .lhs? All you have is “First some imports”, the table of contents, and an empty main. Maybe the “Introduction” can be moved right into it?
For the nameservice section itself, maybe it’d be worthwhile to have a “how this all ties in” as the root of that chapter. (Explain why the files are structured as such as they are)
Ditto for foundation — maybe a brief overview of /how/ BaseApp and all the modules get tied into IO (other than “it just does” as you have later)
fixes #142 fixes #91