docs: add website, scenarios, and agent skill; remove stale docs#194
Merged
Conversation
- Move pg-durable-sql skill from .github/skills to .agents/skills - Add docs/website (renamed from getting-started); link the skill and add 'OSS Durable Functions — coming soon' - Add docs/SCENARIOS.md, docs/ai/, and Sarat_scenarios; reference Sarat scenarios from SCENARIOS.md - Remove docs/bug-bash-april-2026.md and docs/pgai-vectorizer-durable-functions.md
…ge/Hanken/JetBrains type, blueprint atmosphere, motion)
…ario (df.start with & fan-out/fan-in)
…t, anonymize, add operational scenarios section
… examples to SCENARIOS
…ild with operational + Azure use cases
Contributor
Author
|
@pinodeca! When this merges, can you do the following to get the website live! One-time setup (repo admin, in GitHub UI) |
pinodeca
approved these changes
May 29, 2026
Contributor
pinodeca
left a comment
There was a problem hiding this comment.
I asked Opus 4.7 to do a review mostly focused on changes you may have made to existing files. The only finding was a missing trailing newline - that pre-dates your changes.
I would go ahead and merge as-is so we get a 1st version of the website/Pages - then we can improve it as needed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Cleans up
pg_durabledocs and adds a static website, a scenarios guide, and the reusable agent skill.Added
.agents/skills/pg-durable-sql/— moved thepg-durable-sqlagent skill from.github/skills/so agents (e.g. GitHub Copilot) can generate durable-function SQL.docs/website/— static landing page (renamed fromgetting-started), deployed via GitHub Pages. Includes:pg-durable-sqlskill.microsoft/pg_durable.docs/SCENARIOS.md— consolidated scenarios guide:examples/operational-scenarios/(autovacuum blocked, database bloat, wraparound risk, tables not vacuumed).examples/azure-functions/,examples/azure-http-domains/,examples/invoice-approval/.examples/operational-scenarios/— anonymized vacuum/bloat/wraparound DB-ops scenarios (SQL + README + design doc), referenced as Part 2 indocs/SCENARIOS.md..github/workflows/pages.yml— auto-deploysdocs/website/to GitHub Pages on pushes tomain.Removed
docs/bug-bash-april-2026.mddocs/pgai-vectorizer-durable-functions.mdNotes