Move docs to docs/site; add Gemfile + local Jekyll preview doc

Separate published Jekyll content (docs/site/) from any internal docs
that may live alongside it later (ADRs, plans, research, etc.). Matches
the convention used by hyperbee.migrations and the cookiecutter.

- Move all Jekyll content and docs.projitems/docs.shproj into docs/site/
- docs.projitems paths auto-resolve via $(MSBuildThisFileDirectory)
- Update .slnx to point at docs/site/docs.shproj
- Update deploy workflow to build from ./docs/site
- Delete .todo.md
- Add docs/site/Gemfile for local Jekyll preview
- Add docs/site/local-jekyll.md onboarding doc
- .gitignore: add Jekyll build artifacts

Author: bfarmer67

.github/workflows/deploy_github_pages.yml

@@ -33,7 +33,7 @@ jobs:
       - name: Build with Jekyll
         uses: actions/jekyll-build-pages@v1
         with:
-          source: ./docs
+          source: ./docs/site
           destination: ./_site
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

.gitignore

@@ -395,4 +395,12 @@ FodyWeavers.xsd
 *.msp
 
 # JetBrains Rider
-*.sln.iml
+*.sln.iml
+# Jekyll / GitHub Pages local build
+_site/
+.jekyll-cache/
+.jekyll-metadata
+.sass-cache/
+vendor/
+.bundle/
+docs/site/Gemfile.lock

Hyperbee.Resources.slnx

@@ -6,7 +6,7 @@
     <File Path="NuGet.Config" />
     <File Path="README.md" />
     <File Path="version.json" />
-    <Project Path="docs/docs.shproj" />
+    <Project Path="docs/site/docs.shproj" />
   </Folder>
   <Folder Name="/Solution Items/.github/">
     <File Path=".github/dependabot.yml" />

docs/.todo.md

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+gem "jekyll", "~> 4.3"
+gem "just-the-docs"
+
+group :jekyll_plugins do
+  gem "jekyll-remote-theme"
+  gem "jekyll-include-cache"
+  gem "jekyll-seo-tag"
+  gem "jekyll-relative-links"
+end
+
+gem "webrick", "~> 1.8"