On Mon, May 17, 2010 at 3:29 PM, kelvin goodson <kelvingood...@gmail.com> wrote: > I was just thinking about this again. I finished a pass through all > the code, adding the spi javadoc tags where I thought appropriate, and > I got the build so that I could create javadoc, aggregated for example > for the set of module projects. I also began to separate out the > javadoc of packages containing spiu from those that dont. There's > work to do in validating the tagging and then potentially refactoring > the code within packages, but this makes a start. The pom is updated > in the reporting section, which I believe only affects the mvn:site > command, so I hope it doesn't cause anyone any difficulty ther. If it > does I'll have to work out how to do profiles for reporting sections. > > Kelvin. > > On Fri, Apr 16, 2010 at 11:15 AM, kelvin goodson > <kelvingood...@gmail.com> wrote: >> It will certainly help me getter a better grasp of whats there and >> how it is intended to be used. I guess I'd like to think that it would >> prove sufficiently popular with new developers that we would want to >> continue to maintain it, to make Tuscany a more open and accessible >> community to come and join. >> >> Kelvin. >> >> On Fri, Apr 16, 2010 at 9:32 AM, ant elder <antel...@apache.org> wrote: >>> On Fri, Apr 16, 2010 at 8:39 AM, kelvin goodson <kelvingood...@gmail.com> >>> wrote: >>>> My understanding is that there are two distinct sets of classes in the >>>> SPIs, those that are designed for specialisation by the extension >>>> provider and those that are designed to have their methods invoked by >>>> extension provider code calls. I believe that these sets are truly >>>> distinct, i.e. the intersect of these sets is the empty set. It >>>> feels like a useful piece of information to give the extension >>>> programmer. Do you think that there are hybrid classes that make the >>>> intersect non-empty? >>>> >>>> Kelvin. >>>> >>> >>> I'm not sure I see the need, I guess if its useful for what you're >>> doing right now then it doesn't matter but if the intention is to make >>> using these required then I'd want more justification first. >>> >>> ...ant >>> >> >
Great thanks Kelvin. I think it's best to get what we have out there, even if it's in the wiki rather that the site. We can then review it here and decide what course of action to take to tidy up the SPI Java doc. Simon -- Apache Tuscany committer: tuscany.apache.org Co-author of a book about Tuscany and SCA: tuscanyinaction.com
