add more documentation and comments

2 jobs for dev in 46 seconds (queued for 1 second)
latest
Status Job ID Name Coverage
  Test
passed #507290
pages

00:00:46

 
  Deploy
passed pages:deploy

00:00:00