I notice that in the Theme Check plugin when running tests, it displays that it is REQUIRED for add_theme_page() to be used in place of add_menu_page().
I'm not understanding why add_menu_page() is REQUIRED instead of RECOMMENCED? Since add_menu_page() adds a top level menu item, whereas add_theme_page() only adds a submenu under the Appearance top level menu. So basically I don't understand why its required instead of recommended, when WordPress Codex has that method available for wp developers to use? And the various themes sold on RocketThemes and ThemeForest have top level menu items to group and organize their option page menus.
If my admin options I'm making for a theme have many option pages. And I want to group theme together under my own top level menu item, it will be very impractical to use add_theme_page(), which would make all my option pages submenus under the Appearance menu. I want to group my option pages together so the end user doesn't get confused when using my theme and navigating the backend, its also a usability issue!
Thank you for any help regarding my question! And THANK YOU for such a cool Theme Check plugin tool.. Its very helpful!