refactor: move docs and examples to src folder, update README with accurate benchmarks

examples/demo/views/partials/footer.pug

@@ -1,4 +0,0 @@
-footer.footer
-  .container
-    .footer-content
-      p Built with Pugz - A Pug template engine for Zig

examples/demo/views/partials/head.pug

@@ -1,3 +0,0 @@
-meta(charset="UTF-8")
-meta(name="viewport" content="width=device-width, initial-scale=1.0")
-link(rel="stylesheet" href="/css/style.css")

examples/demo/views/partials/header.pug

@@ -1,11 +0,0 @@
-header.header
-  .container
-    .header-content
-      a.logo(href="/") Pugz Store
-      nav.nav
-        a.nav-link(href="/") Home
-        a.nav-link(href="/products") Products
-        a.nav-link(href="/about") About
-      .header-actions
-        a.cart-link(href="/cart")
-          | Cart (#{cartCount})