DoD: get rid of 'integrated'

We're targetting mainline only development. There
won't be an official TI Integration tree from LCPD,
so that requirement can vanish.

While at that, also make it clear we want automated
test scripts.

Acked-by: Chase Maupin <chase.maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

manual: rename the output file

It looks a bit nicer.

Acked-by: Chase Maupin <chase.maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

scope: add pointers to mailing list and github project

Mention those two important pieces of information
as links, so people can figure out how to find
the latest source code for the manual itself.

Acked-by: Chase Maupin <chase.maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

grooming: rename chapter and add initial text

Rename the "Breaking tasks into bite size pieces" chapter into "Work
Breakdown", write an introduction and the descriptions of Epics and
Stories.

Signed-off-by: Luciano Coelho <coelho@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: remove some noise

List of Tables, List of Figures and Document
Revision History were just causing noise.

Remove them.

Acked-by: Chase Maupin <chase.maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add Luca as author

just giving credit.

Acked-by: Luciano Coelho <coelho@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

estimating: add paragraph about having a basic task

* Add a paragraph explaining why having at least one basic task
  makes relative sizing easier.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: roles: discuss about the Functional Manager

add a small clarification about the Functional
Manager and how s/he interacts with ScrumMasters
and Product Owners.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: roles: rename chapter

later patches will come adding more roles to
that chapter. Those roles are TI-specific,
not related to scrum in any way.

Instead of creating a new chapter, it felt
better to just rename what we have.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: terminology: add new terminology section

This covers most of the basic keyworks for Scrum along with some more
LCPD specific items such as mainline / upstream, etc.

Signed-off-by: Darren Etheridge <detheridge@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: meetings: add new meetings chapter

    V2: moves position of chapter in index, and incorporates
    all feedback from team.

    V1: added a new chapter describing each of the meetings in
    scrum.

Signed-off-by: Darren Etheridge <detheridge@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

estimating: Add chapter details

* Fill out the estimating chapter to cover:
    * Why Story Points vs. Hours
    * The online tool we can use
    * Upgrading stories to epics

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

the-sprint: removed section about sprint burndown

* This section discusses a concept covered in basic training and
  is something important to the sprint teams.  At the same time
  since this manual can be read outside of the LCPD team we do
  not want to promote the sprint burndown chart as an artifact
  that should be focused on by people outside of the team as this
  can lead to distracting the teams with questions about the
  burndown.  This chart is meant for the team's use only.
* This was isolated into a separate commit in case it is decided
  to resurrect this section in the future.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

the-sprint: update to focus on sprint and artifacts

* Updated the text to focus on the Sprint process a bit more and
  to add the test code and cases as artifacts generated during
  the sprint.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add Darren as author

Acked-by: Darren Etheridge <detheridge@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

definition-of-done: Add integration requirement

* Add the requirement for Integration as part of Done so make
  sure that we put emphasis on Continuous Integration.
* Update the exceptions section to give examples where this may
  not apply since sometimes there is a reason why something will
  not make it into the Integration tree and is purely for upstream.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

definition-of-done: lots of misc improvements

mostly related to indentation and styles, but
there are good stuff too:

. some more typo fixes
. added commas where necessary
. fixed/improved a list usage (lists in LaTeX
can be nested and LaTeX itself will
use different markers for each list)
. converted a period into a proper paragraph
which made the text slightly easier to
follow (to me, at least).

Acked-by: Chase Maupin <chase.maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

definition-of-done: fix typos

s/i/is/
s/what what/what/
s/is/it/
s/memberes/members/
s//is /

Acked-by: Chase Maupin <chase.maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

definition-of-done: Add initial definition

* Add the initial definition of done.  Covers the three main
  components of the definition, how this differs from acceptance
  criteria, and most importantly how this comes together to
  support the upstream requirement.

* Also made sure to add a section detailing the commitment
  required from the product owner for this to work.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

the-sprint: Add benefit of 2 week sprints

* Added an additional benefit of two week sprints to address a
  common concern of how can we react in a timely fashion to
  customer support escalations without modifying sprints.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

the-sprint: fix typos and enhance readability

* Some changes look larger because of enforcing 80 character
  limits.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

Add Chase as author

Chase has already sent quite a few patches and
can also be listed as author.

Acked-by: Chase Maupin <chase.maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

roles-in-scrum: enhance the team role

* Added some more verbage to the team definition to draw attention
  to the self-directed aspect of the team as well as the trust
  and responsibility of the team member.  This is to help frame
  the power that the team is given within the readers mind and also
  impress upon them the responsibility that comes with that power,
  see SpiderMan for more details.

[ balbi@ti.com : s/port/part ]

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

introduction: Add Scrum benefit

* Add detail on an additional benefit of scrum for focused
  efforts during a sprint.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

Makefile improvements

Output is a lot more terse and running make
multiple times won't remake if it's not necessary
to.

Signed-off-by: Felipe Balbi <balbi@ti.com>

Scrum: fix typo

as Chase pointed out, it's spelled 'practices'.

Signed-off-by: Felipe Balbi <balbi@ti.com>

roles-in-scrum: enhance ScrumMaster Role description

* Make clear that the ScrumMaster role is not the person who
  assigns tasks to the team, but is a servant of the team helping
  to guide their efforts and enable their work.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

roles-in-scrum: enhance product owner role

* Enhance the product owner role to make clear that the product
  owner is trying to maximize bang for buck.
* Added some verbage to introduce the idea of missing merge
  windows as technical debt and why upstreaming efforts may get
  higher priority within a sprint because of this.
    * This will need to be detailed out more.  Likely within
      chapter 6 where we can discuss the idea of every development
      item having a corresponding and immediate upstream item
      in the backlog to ensure the technical debt does not exceed
      the bandwidth of the team.

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

roles-in-scrum: readability fixups

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

roles-in-scrum: Fix line length to 80 characters

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

scope: fix up readability

* Small readibility changes

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

introduction: fix typos

* Fix a couple of typos

Signed-off-by: Chase Maupin <Chase.Maupin@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: the-sprint: add missing section about Burndown Charts

with this patch, we're only missing chapters 6, 7 and 8
for our manual to reach v1.0-rc1. From that point on,
let's try to focus on improvements to the text before we
consider adding new chapters (we could discuss Continuous
Integration and Test-Driven Development, for example).

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: the sprint: lots of improvements

Finished 2 sections, just missing 'Sprint Burndown
Charts' which I'll get to later.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add a chapter to give an overview about Scrum

We have chapter for defining Roles in scrum and
explaining the sprint; clearly we need a chapter
to detail Scrum before going into those other two
items.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: no need for sections in Introduction

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: introduction should be part of mainmatter

if we come up with a preface, than that should
be part of frontmatter.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: introduction: remove bogus 'out'

improves that sentence quite a lot.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add matt porter as an author

Add Matt Porter to author tags and header.

Signed-off-by: Matt Porter <mporter@ti.com>
Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: also mention chapter about estimates

In chapter titled 'The Sprint' we gave a small
taste of what's to come on later chapters but
we didn't mention chapter 'Estimating'.

Fix it by mentioning that chapter as well.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: fix pdftitle attribute

pdftitle attribute from hyperref package didn't
match document's title, fix it.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: move Revision History and Introduction to frontmatter

that means Scope will be Chapter 1.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add a .gitignore file

ignore VIM's .swp files.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add a chapter about 'Estimating'

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: sections to 'Breaking Tasks'

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: scope: couple more paragraphs

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: finish our introduction

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: more text in 'roles in scrum'

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: another paragraph to 'scope'

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: almost complete 'the sprint'

Also add a necessary picture.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add labels

they're really good for cross-referencing.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add more packages

grahpicx, pgfplots, pgfplotstable.

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add list of pictures

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: switch to alpha bibliography style

looks a bit cooler :-)

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: rename main file

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: add some details about the Product Owner

Signed-off-by: Felipe Balbi <balbi@ti.com>

tamm: initial commit

Signed-off-by: Felipe Balbi <balbi@ti.com>