AGENTS.md

1<!-- Guidance for AI agents working in Selenium .NET Bindings -->
2 
3## Code location
4- Core: `dotnet/src/webdriver/`
5- Support: `dotnet/src/support/`
6- Tests: `dotnet/test/common/`
7 
8## Common commands
9- Build: `bazel build //dotnet/...`
10 
11## Testing
12See `dotnet/TESTING.md`
13 
14## Code conventions
15 
16### Logging
17```csharp
18using OpenQA.Selenium.Internal.Logging;
19private static readonly ILogger _logger = Log.GetLogger<MyClass>();
20 
21_logger.Warn("actionable: something needs attention");
22_logger.Info("useful: driver started successfully");
23_logger.Debug("diagnostic: request details for debugging");
24```
25 
26### Deprecation
27```csharp
28[Obsolete("Use NewMethod instead")]
29public void OldMethod() { }
30```
31When code inside the assembly must still reference an obsolete member (e.g. a field
32or method the obsolete API is built on), wrap just that usage to keep the build
33warning-clean (see `UserPromptHandler.cs`):
34```csharp
35#pragma warning disable CS0618 // Type or member is obsolete
36this.legacyThing.DoWork();
37#pragma warning restore CS0618 // Type or member is obsolete
38```
39 
40### Async patterns
41The codebase is migrating to async
42 
43### Documentation
44Use XML documentation comments for public APIs:
45```csharp
46/// <summary>
47/// Brief description.
48/// </summary>
49/// <param name="name">Description.</param>
50/// <returns>Description.</returns>
51/// <exception cref="ExceptionType">When condition.</exception>
52```
53