[yocto] [RFC] Split and revamp distro_tracking_fields.inc

[Saul Wold]

Folks,

As this project has progressed, we have found the distro_tracking_fields
to become a bit cumbersome and dated, I want to therefore propose we get
rid of it ;-), nah that would be too easy!

I would like to propose the following, split it into smaller files with 
more specific meaning, and move some of the data contained in the 
original file into the recipes directly. Some of the fields will be 
deprecated, others renamed and finally others will be used for a burn 
down list of things to be checked or converted to be automagically 
generated.

Currently the data contained in these fields is used to generate the 
database that the Package reporting system uses and will continue to use 
in it's new form. (https://packages.yoctoproject.org) We also use the 
data for tracking the recipe updating to ensure we keep the system as up 
to date as possible.

The new split would make this data part of Poky in meta-yocto, and not 
in oe-core (other than the modifications to the recipes). The split 
would be as follows:

maintainers.inc
  - RECIPE_MAINTAINER = "Full Name <user at example.com>"
  - This is the name of the person currently watching the upstream and
    updating the recipe and/or fixing bugs filed against, this person
    should also help review incoming patches for that recipe.
  - NOTE to REVIEWERS: I still need to better define what the Roles and 
Responsibilities of a maintainer are for recipes!

recipe_color.inc
  - RECIPE_COLOR = "green|yellow|red" - defaults to green
  - Burn down list of recipes that need to be checked for general issues
  - red means there are some issues that might be legacy or function
    need review
  - yellow means recipe needs review
  - once reviewed and issues resolved the recipe's entry can be removed

upstream_tracking.inc
  - RECIPE_UPSTREAM_VERSION = "<version>"
  - RECIPE_UPSTREAM_DATE = "Mmm, dd, yyyy"
    - Version info from the Upstream, mostly this can be generated, but
      in some cases we need to track it manually, this should just be
      the manually tracked info, it currently contains more than that,
      this will be corrected over time as we can generate it
      automatically
  - RECIPE_NO_UPDATE_REASON = "Free form text"
    - Used by the package and update tracking to explain why a recipe
      should not be updated.

Insert into recipe.bb or .inc files:
  - NOTES = <free form text>
    - was RECIPE_COMMENTS
    - Information that would useful in the package reporting system, but
      not part of the DESCRIPTION, could be existing comments
  - CHECK_DATE = "Mmm, dd, yyyy"
    - was RECIPE_MANUAL_CHECK_DATE
    - The date when the upstream was last checked, specifically for the
      Manual check process when a recipe's upstream could not be checked
      automagically, this should become fewer and fewer as we determine
      ways to check.
  - DISTRO_PN_ALIAS = "Distro:package alias, Distro:package alias, ..."
    - This is a comma separated list of mainline distros, such as
      Fedora, Debian, OpenSuse which also ship a similar package, but
      with a different name possibly.
    - Used by package reporting system and is fairly static
    - Many Commercial users would like to know that a given package is
      already shipping with other distributions

Any fields not mentioned above will be deprecated.

The first three files are ready to merged, I need to finish updating the 
recipes for the last part.  This will not require any PR bumps as there 
is no packaging changes, just metadata that is used by the package 
reporting system.


Comments?
-- 
     Sau!

Saul Wold
Yocto Component Wrangler @ Intel
Yocto Project / Poky Build System