docs: Add XML documentation to IZip interface

[thomhurst]

Summary

• Add comprehensive XML documentation to the IZip interface
• Document interface-level summary describing ZIP compression/decompression functionality
• Document all ZipFolder and UnZipToFolder method overloads with parameter descriptions and return values

Fixes #1517

Test plan

• Documentation comments added follow standard XML doc format
• All public methods documented with <summary>, <param>, and <returns> tags
• <see cref> references used appropriately for type links

🤖 Generated with Claude Code

[thomhurst]

Summary

Adds XML documentation comments to the IZip interface methods.

Critical Issues

None found ✅

Verdict

✅ APPROVE - No critical issues

The documentation accurately describes the interface methods, their parameters, and behavior. The default parameter values are correctly documented (CompressionLevel.Optimal for compression, overwriteFiles=true for extraction).

[Copilot]

Pull request overview

This PR adds comprehensive XML documentation to the IZip interface, addressing issue #1517. The documentation follows standard XML doc conventions and provides clear descriptions for all interface members.

• Adds interface-level summary describing ZIP compression/decompression functionality
• Documents all four method overloads (ZipFolder with 2 overloads, UnZipToFolder with 2 overloads) with complete <summary>, <param>, and <returns> tags
• Uses appropriate <see cref> references for File and Folder types from the ModularPipelines.FileSystem namespace

[Copilot]

The documentation states "an exception is thrown for conflicts" but this could be more specific. The underlying ZipFile.ExtractToDirectory method throws an IOException when overwriteFiles is false and a file already exists. Consider being more specific about the exception type for better clarity, similar to how other interfaces in the codebase use specific exception documentation (see IModuleContext which uses <exception> tags).

Suggested change

	/// <param name="overwriteFiles">If <c>true</c>, existing files will be overwritten; otherwise, an exception is thrown for conflicts.</param>
	/// <returns>A <see cref="Folder"/> representing the extraction destination folder.</returns>
	/// <param name="overwriteFiles">If <c>true</c>, existing files will be overwritten; otherwise, an <see cref="System.IO.IOException"/> is thrown when a file conflict occurs.</param>
	/// <returns>A <see cref="Folder"/> representing the extraction destination folder.</returns>
	/// <exception cref="System.IO.IOException">Thrown when <paramref name="overwriteFiles"/> is <c>false</c> and a file to be extracted already exists in the destination.</exception>