[bt-spec] BTP Issue 76 : Need for explanatory material

[BTP issues maintainer <peter.furniss@choreology.com>]

This issue has been added to the BTP issue list

BTP Issue 76 : Need for explanatory material

Submitter: Mark Little, HP
Category: editorial
Description:
I'm not sure if this is covered by other issues, but I definitely think we
should put back some (if not all) of the introductory text from 0.6. After
having talked to people who aren't involved in this specification, and
trying to read it from their p.o.v. it's difficult to understand now. It's
OK us having a separate primer, but if there is no introductory material to
put the specification into context, then we cannot release the specification
without the primer. Some context is required to understand why we have
atoms, cohesions, and other actors. What is the architecture we're assuming,
for example?

---

To comment on this issue, please follow-up to this announcement on the bt-spec@lists.oasis-open.org (replying to this message should automatically send your message to that list).

The current draft, with line numbers is available in pdf format and word format.

To add a new issue, please email to Peter Furniss peter.furniss@choreology.com. It helps if you propose a category (technical, minor technical, editorial, minor editorial).