Merge branch 'main' into next

Author: krlmlr

AGENTS.md

@@ -71,6 +71,7 @@ pak::pak(dependencies = "Config/Needs/build")
 ### Documentation
 
 - Use roxygen2 with Markdown syntax for all function documentation
+- Use explicit `@description` and `@details` sections, aim for a complete description and move only excess details to `@details`
 - Use math notation for formulas: `\eqn{...}` for inline, `\deqn{...}` for display equations
 - Keep each sentence on its own line in roxygen2 comments for better readability
 - Document all arguments and return values