Javadoc overhaul for the Method-Writer stack

[peter-lawrey]

Pull Request – Javadoc overhaul for the Method-Writer stack (#1110)

The Method-Writer code-path (proxy generation, invocation handlers, builders and helpers) is one of Chronicle Wire’s most sophisticated areas, but its documentation lagged behind the implementation:

• Several public classes lacked any contract-level comment.
• Internal helpers had misleading or redundant remarks (“This was a lambda…”).
• IDE quick-docs showed boiler-plate placeholders instead of useful guidance.

Cleaning this up vastly improves discoverability for users building fluent APIs and makes maintenance easier for the team.

What changed?

Area	Classes touched	Highlights
Invocation layer	AbstractMethodWriterInvocationHandler, BinaryMethodWriterInvocationHandler, TextMethodWriterInvocationHandler, MethodWriterInvocationHandlerSupplier, ParameterHolderSequenceWriter	• Clarified record-history, method-ID and generic-event semantics • Documented caching strategy and thread-safety behaviour
Proxy generation (v1 & v2)	GenerateMethodWriter, GenerateMethodWriter2, MethodWriterClassNameGenerator	• Added end-to-end class/field/method docs explaining name mangling, template use, hash logic & fallbacks • Removed verbose “what this method returns” boiler-plate and replaced with focused info
Builder & API contracts	VanillaMethodWriterBuilder, MethodWriter, MethodWriterValidationException	• Detailed fluent options, fallback paths, and error cases • Linked to public entry points (MarshallableOut#methodWriter…)
Validation & Exceptions	MethodWriterValidationException	• Now states why fallback to reflection is not performed
Misc. helpers	MethodWriterClassNameGenerator	• Explained naming algorithm, hash converter, and length guard

comment-only — absolutely no byte-code or runtime behaviour change.