<div dir="ltr">Team,<div><br></div><div>Apologies, I accidently took my original reply to Gerald off-list, so now I'm going to top-post.</div><div><br></div><div>I suggested the following:</div><div><blockquote style="margin:0px 0px 0px 40px;border:none;padding:0px"><div><span style="font-size:12.8px">What if instead we changed the "Use Cases" header to "Requirements Specification" and the "User Stories" sub-header to "Use Cases"? This seems like a simpler change that achieves the same result.</span></div><div><span style="font-size:12.8px"><br></span></div></blockquote><span style="font-size:12.8px">Gerald agreed and I've submitted a patch to this effect.[1]</span></div><div><span style="font-size:12.8px"><br></span></div><div><span style="font-size:12.8px">[1] <a href="https://review.openstack.org/424228">https://review.openstack.org/424228</a></span></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jan 20, 2017 at 4:21 AM, Kunzmann, Gerald <span dir="ltr"><<a href="mailto:kunzmann@docomolab-euro.com" target="_blank">kunzmann@docomolab-euro.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Dear Product team,<br>
<br>
based on the recent discussions on the "gap analysis template", I'd like to trigger some discussion on the terminology we are using:<br>
<br>
We use the term "user story" for the whole document, but we also use the term "user stories" for the individual bullet points in the "use cases" section of the template [3]. In addition, the template talks about "The title of your use case" and inside we have a section "use cases" (plural).<br>
<br>
This is quite confusing as we are mixing the terms "user story" and "use case" in singular/plural in different places.<br>
I have already seen multiple occasions where this has led to misunderstandings in discussions (e.g. see line 35 in [2]) .<br>
Conceptually,<br>
  a) the sentences we have in the section "use cases" are the real "user stories". [1]<br>
  b) a "user story" is something different than a "user story", but on a similar level, so the title of that section is already misleading. [1]<br>
  c) the whole document could be seen as a "requirement specification".<br>
<br>
Simple solution:<br>
- change from "user story" to "use case" (like also the title of the template is indicating). This would mean we have a "use case tracker" and it would also require few changes on the Wiki page.<br>
- keep the term "user stories" for the user story sentences.<br>
- change the section from "use cases to "Requirement specifications"<br>
<br>
Of course we could also discuss about a more "complete" solution, where we revisit all terms used and change to e.g. "requirement specification" for the whole document (e.g. "baremetal requirement specification").<br>
<br>
What do you think?<br>
<br>
Best regards,<br>
Gerald<br>
<br>
<br>
[1] <a href="https://en.wikipedia.org/wiki/User_story#Comparing_with_use_cases" rel="noreferrer" target="_blank">https://en.wikipedia.org/wiki/<wbr>User_story#Comparing_with_use_<wbr>cases</a><br>
[2] <a href="https://etherpad.openstack.org/p/template_gap_and_overlap_analysis" rel="noreferrer" target="_blank">https://etherpad.openstack.<wbr>org/p/template_gap_and_<wbr>overlap_analysis</a><br>
[3] <a href="https://github.com/openstack/openstack-user-stories/blob/master/user-story-template.rst" rel="noreferrer" target="_blank">https://github.com/openstack/<wbr>openstack-user-stories/blob/<wbr>master/user-story-template.rst</a><br>
______________________________<wbr>_________________<br>
User-committee mailing list<br>
<a href="mailto:User-committee@lists.openstack.org">User-committee@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/user-committee" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/user-<wbr>committee</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr">Kenny Johnston | irc:kencjohnston | @kencjohnston</div></div>
</div>