w3c / wot-usecases

Repository of the WoT IG to discuss possible WoT use cases
https://w3c.github.io/wot-usecases/
21 stars 34 forks source link

Define "Feature Request" terminology #304

Open mmccool opened 3 days ago

mmccool commented 3 days ago

Proposal for process in meeting on Oct 9 was as follows:

It would be good to create clear definitions of these terms, e.g. "Feature Request" (and use case, and requirement, and category). Will do so in the discussion part of this issue (or maybe make a PR for an MD file...).

See also:

relu91 commented 3 days ago

I'm totally in favor of this new definition of streamlining "developer-oriented" requests. About "If accepted, a feature request becomes a requirement" I think it might be useful to have "acceptance criteria" as a field in the Feature Request proposal to extract actionable requirements because sometimes it might not be obvious from the user story.

In the end, we could have this simple template:

[Title]

As a [user type/persona], I [want to], [so that].

Use cases

Acceptance criteria - optional

One thing that we might have to do is to prepare a list of readable personas or user-types (but the issuer might add new user types or personas if they want).