On Wed, May 26, 2010 at 10:01 AM, kelvin goodson <[email protected]> wrote: > I created a glossary in the 2.x documentation the other day [1] --- I > specifically needed to reference a couple of terms from within a > README. Those two items now look a bit lonely, so I wondered if we > could together to slowly build this up. > > My thought is that each day someone proposes a term, be it related to > the SCA specs, to tuscany user concepts or to the code structure. > Ideally (but not necessarily) the proposer also supplies a candidate, > description of the term, roughly tweet sized. Anyone can chip in with > a refinement of the description, and at the end of the week say, I'd > be happy to harvest the fruits of our labours and put them in the > glossary. > > In thinking about this, I wasn't sure if it was something that was > best suited to the user list or the dev list. I think at least for the > moment it's best on the dev list and if it flies we could perhaps post > digests of relevant terms to the user list. We could tag the term with > tags like sca, tuscany, user, developer etc. > > Here's a starter, (a slight cheat as it's a précis from the website > intor pages) ... > > > binding: a binding provides a protocol specific means of communication > between distributed elements of an SCA application. For example JMS, > Webservices and Atom bindings. (tags: SCA, user) > > [1] http://tuscany.apache.org/documentation-2x/glossary.html >
There is a section on SCA concepts in Appendix B of the Assembly spec - http://docs.oasis-open.org/opencsa/sca-assembly/sca-assembly-1.1-spec.pdf The descriptions are a little longer than what you're suggesting but they are quite clear and maybe they could be used to seed the list. ...ant
