Move docs to docs/site; add Gemfile for local Jekyll preview

* 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

* Also ignore .claude/ (Claude Code scratch dir)

* Strip UTF-8 BOMs and replace non-ASCII chars with ASCII

just-the-docs / Jekyll fails intermittently on files with BOMs or
stray Unicode. Sweep docs/site/:
- Strip BOM (EF BB BF) from all text files (*.md, *.yml, *.html)
- Replace em-dash \u2014 with --
- Replace en-dash \u2013 with -
- Replace nbsp U+00A0 with regular space
- Replace right arrow \u2192 with ->
- Replace mu \u03bc with u (microseconds become us in benchmark tables)

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,15 @@ 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
+
+# Claude Code scratch directory (local, not shared)
+.claude/

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"

docs/site/Gemfile

@@ -1,4 +1,4 @@
-title: Hyperbee Resources
+title: Hyperbee Resources
 description: Documentation for Hyperbee Resources.
 remote_theme: pmarsceill/just-the-docs
 baseurl: "/hyperbee.resources/"

docs/_config.yml docs/site/_config.ymldocs/_config.yml renamed to docs/site/_config.yml

@@ -1,3 +1,3 @@
-<footer class="site-footer">
+<footer class="site-footer">
     Hyperbee Resources Docs
 </footer>