On Aug 1, 2011, at 4:48 PM, Raminderjeet Singh wrote: >>> - clients - client jars will ne needed for integration. The services will >>> be built as aar files, so ideally clients should not be needing any server >>> jars and only client jars >>> - samples - will show how to utilize the client jars and address component > Samples at component level are more like client and client unit test. The > idea is to show how the client code works. We should not duplicate that code. > For sure we should create useful API document and client documentation for > users.
Good point, I agree, samples should strengthen the documentation. Only when using a client code is not self-explanatory, we will need to add sample use cases which demonstrate different ways of integrating the client code. The subtle difference is: the client jar will be needed by the third party component but the sample is more for a reference. I do agree that there will be more over lap of samples with unit tests, but unit tests are to ensure a functional piece within the source code, it may not test the changes well enough with all the context, which is supposed to be tested by the bundled samples. Suresh
