Add comprehensive documentation for metadata type definitions

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot