Skip to content

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

Merged
bfarmer67 merged 3 commits intomainfrom
chore/docs-site-layout
Apr 13, 2026
Merged

Move docs to docs/site; add Gemfile for local Jekyll preview#71
bfarmer67 merged 3 commits intomainfrom
chore/docs-site-layout

Conversation

@bfarmer67
Copy link
Copy Markdown
Contributor

Matches the pattern in hyperbee.migrations and the cookiecutter. Local Jekyll build validated for this repo.

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
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)
@bfarmer67 bfarmer67 merged commit da46b3e into main Apr 13, 2026
12 checks passed
@bfarmer67 bfarmer67 deleted the chore/docs-site-layout branch April 13, 2026 02:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant