CHEF-28667 - Add comprehensive documentation for pedant tests

- adding signature for the commit
- 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

Signed-off-by: talktovikas <vikas.yadav@progress.com>

Author: talktovikas