@@ -245,8 +245,18 @@ compile $ pageCompiler
245245 >>> relativizeUrlsCompiler
246246~~~~~~
247247
248−How should we process these pages? A simple compiler such as [pageCompiler],
249−which renders the page, is not enough, we also want to apply our template.
248+How should we process these pages? [pageCompiler] is the default compiler for
249+pages. [pageCompiler] does a few things:
250+
251+- It parses the page into body and metadata
252+- It adds some extra metadata fields such as `$url$` and `$path$` (you shouldn't
253+ worry about these for now)
254+- It fill in possible `$key$`'s in it's own body
255+- It renders the page using pandoc
256+
257+Which basically means that we end up with a `Page` that has the HTML content we
258+want as body. But we don't just want the plain content on our website -- we want
259+to decorate it with a template, for starters.
250260
251261[pageCompiler]: /reference/Hakyll-Web-Page.html#v:pageCompiler
252262