Improve documentation clarity across schema and constraint classes

[leoafarias]

Summary

This PR improves documentation clarity throughout the codebase by refining docstrings, removing redundant explanations, and using proper markdown formatting for code references.

Key Changes

• List schema extensions: Simplified docstrings for alias methods (minLength, maxLength, length, notEmpty) by removing the phrase "to mirror documentation naming"

• Comparison constraint: Cleaned up class documentation by removing redundant statements about nullable type handling and using markdown formatting for code references

• Object schema extensions: Simplified the extend() method documentation by removing vague language about "additional constructor" and clarifying that "schema properties" should be "schema settings"

• String schema extensions: Enhanced url() method documentation to clarify it validates URIs (not just URLs) and added a note that it's an alias for uri()

• Fluent schema mixin: Improved optional() method documentation to be more concise and added a reference to AckSchemaExtensions.optional for detailed semantics

• String literal constraint: Simplified documentation by removing the redundant statement about null handling and using markdown formatting

• Validators: Updated InvalidTypeConstraint documentation to be more specific about its usage context and use proper markdown formatting

• Ack schema extensions: Enhanced transform() method documentation to clarify that the transformer receives T? due to nullable/optional base schemas

• Ack factory: Added missing documentation for the enumString() factory method

Notable Details

All changes maintain backward compatibility and only affect documentation/comments. The improvements focus on consistency, clarity, and proper use of markdown formatting for code references.

https://claude.ai/code/session_016wyFrpbjHmLNXzKn4BQ5d7

[docs-page]

To view this pull requests documentation preview, visit the following URL:

docs.page/btwld/ack~94

Documentation is deployed and generated using docs.page.