ISSUE-70 (usecases-in-spec): Should we have use-cases in specifications [APIs — General]

ISSUE-70 (usecases-in-spec): Should we have use-cases in specifications [APIs — General]

http://www.w3.org/2009/dap/track/issues/70

Raised by: Max Froumentin
On product: APIs — General

Should specifications have a use-case section? Or should the decision be made on a case-by-case basis?

Max's claim: Use-cases (and requirements) are helps, meant for writing the specification itself, but not part of the specification. Examples are ok, as they help the implementer get a quick overview of a specific API, but use-cases are just as well replaced by more generic wording saying "this specification enables webapps to do XXX, YYY and ZZZ".

Received on Wednesday, 27 January 2010 10:42:37 UTC