CHEF-28667 - Add comprehensive documentation for pedant tests

- Created detailed test suite documentation covering architecture, organization, and usage
- Documented all API test categories with examples
- Added troubleshooting section and best practices
- Included configuration patterns and writing guidelines
- AI-assisted documentation following Progress AI policies

Author: talktovikas