This module has been found very useful. There is a lot of modules declared as a friend and has been quite stable. The
packages that are exposed to friends can be made public. Please review.
Earlier, I requested review of this module. See issue 98420. Please let me know if anything is missing.
[JG01] What package would be used? org.netbeans.modules.xml.axi.** is not appropriate for public packages.
It doesn't seem like there was any substantive review in issue #98420. (I am not personally qualified to review it.)
Have enough distinct people used this module since it was stabilized to have confidence that the API is correct?
Yes, the package name starts with "org.netbeans.modules.xml.axi". axi is an acronym for Abstract XML Instance. Do you
have any other suggestions?
More specifically the request is to make these three packages public:
These APIs are being used by a lot of modules and have been around since 2006. I have found this very stable and has a
lot of unit tests. Please see http://xml.netbeans.org/specs/axiom/axiom.html for some use-cases.
JG01 - see: http://openide.netbeans.org/tutorial/api.html#restrictions
Does it mean that I have to change the package names?
That would be the usual recommendation. I don't personally have a strong opinion about it.
PH01: I would like to see javadoc improved. Two use cases are described as simple sentences without any link to class or
sample. There is no list of exported API. So the user of API might get feeling that this API could solve his usecase,
but he has no clue how to use it or where to start. From my point of view it would be really hard to use the API without
copy-pasting some working code.
Re: PH01: I agree with your comments. I'll have all the docs in place soon.