Rename RealForPath* to RealGitRootForPath* for clarity

RealForPath → RealGitRootForPath
RealForPathWrite → RealGitRootForPathWrite

The Git prefix makes explicit that these factory methods resolve the scope
root by walking up to the nearest .git boundary from the given path.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Author: Mpdreamz

src/Elastic.Documentation.Configuration/FileSystemFactory.cs

@@ -144,7 +144,7 @@ public static ScopedFileSystem ScopeSourceDirectoryForWrite(IFileSystem inner, s
 	/// and do not exercise this method.
 	/// </para>
 	/// </summary>
-	public static ScopedFileSystem RealForPath(string? path)
+	public static ScopedFileSystem RealGitRootForPath(string? path)
 	{
 		if (path is null)
 			return RealRead;
@@ -162,7 +162,7 @@ public static ScopedFileSystem RealForPath(string? path)
 	/// Falls back to <see cref="RealWrite"/> when both are <see langword="null"/>.
 	/// Use in commands that accept explicit <c>--path</c> and/or <c>--output</c> arguments.
 	/// </summary>
-	public static ScopedFileSystem RealForPathWrite(string? path, string? output = null)
+	public static ScopedFileSystem RealGitRootForPathWrite(string? path, string? output = null)
 	{
 		if (path is null && output is null)
 			return RealWrite;

src/tooling/docs-builder/Commands/DiffCommands.cs

@@ -29,7 +29,7 @@ public async Task<int> ValidateRedirects(string? path = null, Cancel ctx = defau
 		await using var serviceInvoker = new ServiceInvoker(collector);
 
 		var service = new LocalChangeTrackingService(logFactory, configurationContext);
-		var fs = FileSystemFactory.RealForPath(path);
+		var fs = FileSystemFactory.RealGitRootForPath(path);
 
 		serviceInvoker.AddCommand(service, (path, fs),
 				async static (s, collector, state, _) => await s.ValidateRedirects(collector, state.path, state.fs)

src/tooling/docs-builder/Commands/FormatCommand.cs

@@ -43,7 +43,7 @@ public async Task<int> Format(
 		await using var serviceInvoker = new ServiceInvoker(collector);
 
 		var service = new FormatService(logFactory, configurationContext);
-		var fs = FileSystemFactory.RealForPath(path);
+		var fs = FileSystemFactory.RealGitRootForPath(path);
 
 		serviceInvoker.AddCommand(service, (path, check, fs),
 			async static (s, collector, state, ctx) => await s.Format(collector, state.path, state.check, state.fs, ctx)

src/tooling/docs-builder/Commands/IndexCommand.cs

@@ -86,7 +86,7 @@ public async Task<int> Index(
 	)
 	{
 		await using var serviceInvoker = new ServiceInvoker(collector);
-		var fs = FileSystemFactory.RealForPath(path);
+		var fs = FileSystemFactory.RealGitRootForPath(path);
 		var service = new IsolatedIndexService(logFactory, configurationContext, githubActionsService, environmentVariables);
 		var state = (fs, path,
 				// endpoint options

src/tooling/docs-builder/Commands/IsolatedBuildCommand.cs

@@ -62,9 +62,9 @@ public async Task<int> Build(
 		await using var serviceInvoker = new ServiceInvoker(collector);
 
 		var service = new IsolatedBuildService(logFactory, configurationContext, githubActionsService, environmentVariables);
-		var readFs = inMemory ? FileSystemFactory.InMemory() : FileSystemFactory.RealForPath(path);
+		var readFs = inMemory ? FileSystemFactory.InMemory() : FileSystemFactory.RealGitRootForPath(path);
 		// For real builds supply an explicit write FS without .git access; for in-memory null falls back to readFs
-		var writeFs = inMemory ? null : FileSystemFactory.RealForPathWrite(path, output);
+		var writeFs = inMemory ? null : FileSystemFactory.RealGitRootForPathWrite(path, output);
 		var strictCommand = service.IsStrict(strict);
 
 		serviceInvoker.AddCommand(service,

src/tooling/docs-builder/Commands/MoveCommand.cs

@@ -38,7 +38,7 @@ public async Task<int> Move(
 		await using var serviceInvoker = new ServiceInvoker(collector);
 
 		var service = new MoveFileService(logFactory, configurationContext);
-		var fs = FileSystemFactory.RealForPath(path);
+		var fs = FileSystemFactory.RealGitRootForPath(path);
 
 		serviceInvoker.AddCommand(service, (source, target, dryRun, path, fs),
 			async static (s, collector, state, ctx) => await s.Move(collector, state.source, state.target, state.dryRun, state.path, state.fs, ctx)

src/tooling/docs-builder/Commands/ServeCommand.cs

@@ -27,7 +27,7 @@ internal sealed class ServeCommand(ILoggerFactory logFactory, IConfigurationCont
 	[Command("")]
 	public async Task Serve(string? path = null, int port = 3000, bool watch = false, Cancel ctx = default)
 	{
-		var host = new DocumentationWebHost(logFactory, path, port, FileSystemFactory.RealForPath(path), FileSystemFactory.InMemory(), configurationContext, watch);
+		var host = new DocumentationWebHost(logFactory, path, port, FileSystemFactory.RealGitRootForPath(path), FileSystemFactory.InMemory(), configurationContext, watch);
 		await host.RunAsync(ctx);
 		_logger.LogInformation("Find your documentation at http://localhost:{Port}/{Path}", port,
 			host.GeneratorState.Generator.DocumentationSet.FirstInterestingUrl.TrimStart('/')

src/tooling/docs-builder/Http/InMemoryBuildState.cs

@@ -169,7 +169,7 @@ private async Task ExecuteBuildAsync(string sourcePath, Cancel ct)
 			// Create a diagnostics collector that streams to our channel
 			var streamingCollector = new StreamingDiagnosticsCollector(_loggerFactory, this);
 
-			var readFs = FileSystemFactory.RealForPath(sourcePath);
+			var readFs = FileSystemFactory.RealGitRootForPath(sourcePath);
 			var service = new IsolatedBuildService(_loggerFactory, _configurationContext, new NullCoreService(), SystemEnvironmentVariables.Instance);
 
 			_logger.LogInformation("Starting in-memory validation build for {Path}", sourcePath);

src/tooling/docs-builder/Http/StaticWebHost.cs

@@ -25,7 +25,7 @@ public class StaticWebHost
 	public StaticWebHost(int port, string? path)
 	{
 		_contentRoot = path ?? Path.Join(Paths.WorkingDirectoryRoot.FullName, ".artifacts", "assembly");
-		var fs = FileSystemFactory.RealForPath(path);
+		var fs = FileSystemFactory.RealGitRootForPath(path);
 		var dir = fs.DirectoryInfo.New(_contentRoot);
 		if (!dir.Exists)
 			throw new Exception($"Can not serve empty directory: {_contentRoot}");