Skip to content

Document agentic contribution workflow - #1266

Merged
dsyme merged 1 commit into
mainfrom
docs/agentic-contributions
Aug 25, 2026
Merged

dsyme merged 1 commit into
mainfrom
docs/agentic-contributions

Conversation

@dsyme

@dsyme dsyme commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Summary

  • prefer issues for human-guided agentic maintenance
  • require pull requests to have a matching, discussed issue
  • document scheduled and maintainer-directed Repo Assist tasks
  • preserve repository-specific contribution and validation guidance

Closes #1265.

Validation

  • git diff --check -- CONTRIBUTING.md

@dsyme
dsyme merged commit d591b93 into main Aug 25, 2026
11 checks passed
@dsyme
dsyme deleted the docs/agentic-contributions branch August 25, 2026 00:05
dsyme added a commit that referenced this pull request Sep 8, 2026
dsyme added a commit that referenced this pull request Sep 8, 2026
…1264)

* Add support for top-level <seealso> XML doc tags in API docs

Renders a 'See also' section (list of links) for members and entities
that have top-level <seealso cref="..."/> XML doc tags, per the
xmldoc recommended-tags convention. Previously these tags were
silently ignored.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Document agentic contribution workflow (#1266)

* Bump Suave from 2.6.2 to 3.4.6 (#1272)

Migrate the fsdocs watch server to Suave 3's Task-based socket API:
the websocket handler and reload broadcast now use ValueTask/Result,
the removed Suave.Logging module is dropped, and the server task from
startWebServerAsync is already hot so it no longer needs Async.Start.

While migrating, fix a crash in watch mode: clients that disconnect
without a close handshake stayed registered, and broadcasting to such
a dead socket throws ObjectDisposedException in Suave 3, killing the
whole watch process. Clients are now deregistered whenever their
connection ends, and the broadcast tolerates stale sockets.

Also in watch mode, the logo now links to the locally hosted site
root instead of the production URL (even when <FsDocsLogoLink> is
set), and the console no longer logs websocket connection chatter on
every page reload. Release builds are unaffected.

Bump Fun.Build from 1.0.4 to 1.1.18 and make build.fsx directly
executable via a dotnet fsi shebang.

Release notes: 22.2.0.

* Improve Mermaid setup (#1274)

* Move the Mermaid example from docs/sidebyside/sidemermaid.md to
docs/mermaid.md and rewrite it around plain ```mermaid fenced blocks
promoted by a docs/_body.html script, the pattern used by the fantomas
docs. The source now renders on GitHub and the recipe page actually
renders its own diagrams.

* Add Docs pipeline to easily launch documentation locally.

* Add support for top-level <seealso> XML doc tags in API docs

Renders a 'See also' section (list of links) for members and entities
that have top-level <seealso cref="..."/> XML doc tags, per the
xmldoc recommended-tags convention. Previously these tags were
silently ignored.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Don Syme <dsyme@users.noreply.github.com>
Co-authored-by: Florian Verdonck <florian.verdonck@outlook.com>
Co-authored-by: Don Syme <dsyme@github.com>
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.

Document agentic contribution workflow

1 participant