We've posted a detailed set of guidelines for using the JMX API, the result of several years' experience with it. Starting from the JMX Technology Home Page at http://java.sun.com/jmx, you can now find a link "JMX Best Practices" in the navigation bar at the left, leading you to the detailed best practices document. This covers many basic and advanced topics, such as how to name MBeans, how to choose between the different kinds of MBeans, how to handle complex data types, MBean interface evolution, and correct use of notifications. Although this is already a fairly big document, there might be other areas that you'd like to see covered, or problems that you see with the existing text. Feedback would be very welcome, either here or at jmx-spec-comments@sun.com.