Please provide GigaSpaces source and Javadoc jars. Jars + Javadoc for parts of GigaSpaces which are open source could be included in the standard GigaSpaces distribution. Parts that are closed source may be provided to customers on a password-protected download site.
For most projects managed in Maven, it is common to provide the source and Javadoc jars which exactly correspond to binary jars. Since GigaSpaces code is divided on multiple jars (xap-common, xap-openspaces, xap-datagrid etc), the source code and Javadoc jars shall be divided correspondingly. Your efforts to implement this are absolutely minimal if you use Maven to build GigaSpaces you get it for free just by adding 2 Maven plug-ins in your configuration.
Having source and Javadoc jars is very important for the efficient use of IDEs. Javadoc jars are used by IDEs to provide context help. Source jars are required to debug errors in the GigaSpaces code. Taking into account that we repeatedly encounter and report to you bugs (real or suspected) in GigaSpaces code, it would be very useful to get GigaSpaces source code in a readable form.
We may use a decompiler, but there is no guarantee that it will preserve line numbers, so we are not able to tell you "it looks like an error in line 123 of class XYZ".