Create annotated Starterkit

site/templates/home.php

@@ -1,17 +1,32 @@
+<?php
+/**
+ * Templates render the content of your pages. 
+ * They contain the markup together with some control structures like loops or if-statements.
+ * This home template renders content from others pages, the children of the `photography` page to display a nice gallery grid.
+ * Snippets like the header and footer contain markup used in multiple templates. They also help to keep templates clean.
+ * More about templates: https://getkirby.com/docs/guide/templates/basics
+ */
+?>
+
 <?php snippet('header') ?>
 
 <main>
-  <header class="intro">
-    <h1><?= $site->title() ?></h1>
-  </header>
+  <?php snippet('intro') ?>
 
-  <?php if ($photographyPage = page('photography')): ?>
+
+  <?php 
+  // we always use an if-statement to check if a page exists to prevent errors 
+  // in case the page was deleted or renamed before we call a method like `children()` in this case
+  if ($photographyPage = page('photography')): ?>
   <ul class="grid">
     <?php foreach ($photographyPage->children()->listed() as $album): ?>
     <li>
       <a href="<?= $album->url() ?>">
         <figure>
-          <?php if ($cover = $album->cover()): ?>
+          <?php 
+          // the `cover()` method defined in the `album.php` page model can be used 
+          // everywhere across the site for this type of page
+          if ($cover = $album->cover()): ?>
           <?= $cover->resize(1024, 1024) ?>
           <?php endif ?>
           <figcaption>