Skip to content

AGENTS.md

Latest commit

 

History

History
60 lines (41 loc) · 1.4 KB

AGENTS.md

File metadata and controls

60 lines (41 loc) · 1.4 KB

Agent Guidelines

Release Notes

Update RELEASE_NOTES.md when making user-visible changes:

  • Add entries under the ## [Unreleased] section
  • Use categories: ### Added, ### Changed, ### Fixed, ### Removed
  • Include PR links: [#123](https://github.com/fsprojects/FSharp.Formatting/pull/123)

Code Formatting

Format code using Fantomas before committing:

dotnet tool restore
dotnet fantomas build.fsx src tests docs

Check formatting without modifying files:

dotnet fantomas build.fsx src tests docs --check

Configuration is in .editorconfig.

CI Checks

Run these checks locally before pushing:

# Full CI pipeline (lint, build, test, docs)
dotnet fsi build.fsx

# Just lint and test
dotnet fsi build.fsx -- -p Verify

# Run analyzers (G-Research.FSharp.Analyzers, Ionide.Analyzers)
dotnet msbuild /t:AnalyzeSolution

Individual steps:

dotnet restore FSharp.Formatting.sln
dotnet build FSharp.Formatting.sln --configuration Release
dotnet test FSharp.Formatting.sln --configuration Release --no-build

Testing Locally Against Another Project

After building the repo with dotnet build, run the tool directly from the build output in your project's directory:

# macOS / Linux
/path/to/FSharp.Formatting/src/fsdocs-tool/bin/Debug/net10.0/fsdocs build

# Windows
\path\to\FSharp.Formatting\src\fsdocs-tool\bin\Debug\net10.0\fsdocs.exe build