[PATCH 0/2] EdkRepo - The Multi-Repository Tool for EDK II

[PATCH 0/2] EdkRepo - The Multi-Repository Tool for EDK II

[Nate DeSimone]

This patch series is raised to add the EdkRepo and EdkRepo-Manifest branches
to the Edk2-Staging repository. These branches are added to host EdkRepo,
the multi-repository tool for EDK II firmware development to TianoCore.

For more details on EdkRepo, please see my RFC.

Nate DeSimone (2):
  Add EdkRepo - The Multi-Repo Tool
  Add EdkRepo manifest XML

-- 
2.16.2.windows.1

[PATCH 1/2] [staging/EdkRepo]: Add EdkRepo - The Multi-Repo Tool

[Nate DeSimone]

Signed-off-by: Nate DeSimone <nathaniel.l.desimone@intel.com>
Cc: Andrew Fish <afish@apple.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
---
 Maintainers.txt | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md       | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 82 insertions(+)
 create mode 100644 Maintainers.txt
 create mode 100644 README.md

diff --git a/Maintainers.txt b/Maintainers.txt
new file mode 100644
index 0000000000..7fce863cce
--- /dev/null
+++ b/Maintainers.txt
@@ -0,0 +1,50 @@
+EDK II Maintainers
+==================
+
+This file provides information about the primary maintainers for
+EdkRepo.
+
+In general, you should not privately email the maintainer. You should
+email the edk2-devel list, but you can also Cc the maintainer.
+
+Descriptions of section entries:
+
+  L: Mailing list that is relevant to this area (default is edk2-devel)
+     Patches and questions should be sent to the email list.
+  M: Cc address for patches and questions (ie, the package maintainer)
+  R: Package Reviewer: Cc address for patches and questions. Reviewers help
+     maintainers review code, but don't have push access. A designated Package
+     Reviewer is reasonably familiar with the Package (or some modules
+     thereof), and/or provides testing or regression testing for the Package
+     (or some modules thereof), in certain platforms and environments.
+  W: Web-page with status/info
+  T: SCM tree type and location.  Type is one of: git, svn.
+  S: Status, one of the following:
+     Supported:  Someone is actually paid to look after this.
+     Maintained: Someone actually looks after it.
+     Odd Fixes:  It has a maintainer but they don't have time to do
+                 much other than throw the odd patch in. See below.
+     Orphan:     No current maintainer [but maybe you could take the
+                 role as you write your new code].
+     Obsolete:   Old code. Something tagged obsolete generally means
+                 it has been replaced by a better system and you
+                 should be using that.
+
+EDK II
+------
+W: https://github.com/tianocore/tianocore.github.io/wiki/EDK-II
+L: https://edk2.groups.io/g/devel/
+T: git - https://github.com/tianocore/edk2-staging.git
+
+Responsible Disclosure, Reporting Security Issues
+-------------------------------------------------
+W: https://github.com/tianocore/tianocore.github.io/wiki/Security
+
+EDK II Packages:
+----------------
+
+EdkRepo
+W: https://github.com/tianocore/edk2-staging/tree/EdkRepo
+M: Nate DeSimone <nathaniel.l.desimone@intel.com>
+M: Ashley DeSimone <ashley.e.desimone@intel.com>
+R: Puja Pandya <puja.pandya@intel.com>
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..2a6c2fc003
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+This branch is for integrating the EdkRepo tool in to EDK2
+
+# Introduction
+
+EdkRepo is the multi-repository tool for EDK II firmware development. EdkRepo is built on top of git. It is intended to automate common developer workflows for projects that use more than one git repository. For example many of the new projects in the edk2-platforms repository require the user to clone several git repositories. EdkRepo makes it easier to set up and upstream changes for these projects. EdkRepo does not replace git, rather it provides higher level extensions that make it easier to work with git. EdkRepo is written in Python and is compatible with Python 3.5 or later.
+
+# Timeline
+| Time | Event |
+|:----:|:-----:|
+| WW 24 2019 | Initial commit of EdkRepo |
+|...|...|
+
+# Branch Owners
+- Ashley DeSimone <ashley.e.desimone@intel.com>
+- Nate DeSimone <nathaniel.l.desimone@intel.com>
+
+# Integration
+EdkRepo could live in several places:
+1. edk2-platforms
+2. edk2-pytool-library
+3. The edk2-toolenv repository proposed by Sean (assuming approval of Sean’s RFC)
+4. A new, separate repository created for EdkRepo
+
+This is a topic that requires community discussion to decide what the final location should be.
+
+# Known Issues
+| Issue | Status |
+|:-----:|:------:|
+|...|...|
+
+# Related Links
+- https://edk2.groups.io/g/devel/message/42227
+- https://github.com/tianocore/edk2-platforms
-- 
2.16.2.windows.1

[PATCH 2/2] [staging/EdkRepo-Manifest]: Add EdkRepo manifest XML

[Nate DeSimone]

Signed-off-by: Nate DeSimone <nathaniel.l.desimone@intel.com>
Cc: Andrew Fish <afish@apple.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
---
 Maintainers.txt | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md       | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 82 insertions(+)
 create mode 100644 Maintainers.txt
 create mode 100644 README.md

diff --git a/Maintainers.txt b/Maintainers.txt
new file mode 100644
index 0000000000..de4817f6ee
--- /dev/null
+++ b/Maintainers.txt
@@ -0,0 +1,50 @@
+EDK II Maintainers
+==================
+
+This file provides information about the primary maintainers for
+EdkRepo.
+
+In general, you should not privately email the maintainer. You should
+email the edk2-devel list, but you can also Cc the maintainer.
+
+Descriptions of section entries:
+
+  L: Mailing list that is relevant to this area (default is edk2-devel)
+     Patches and questions should be sent to the email list.
+  M: Cc address for patches and questions (ie, the package maintainer)
+  R: Package Reviewer: Cc address for patches and questions. Reviewers help
+     maintainers review code, but don't have push access. A designated Package
+     Reviewer is reasonably familiar with the Package (or some modules
+     thereof), and/or provides testing or regression testing for the Package
+     (or some modules thereof), in certain platforms and environments.
+  W: Web-page with status/info
+  T: SCM tree type and location.  Type is one of: git, svn.
+  S: Status, one of the following:
+     Supported:  Someone is actually paid to look after this.
+     Maintained: Someone actually looks after it.
+     Odd Fixes:  It has a maintainer but they don't have time to do
+                 much other than throw the odd patch in. See below.
+     Orphan:     No current maintainer [but maybe you could take the
+                 role as you write your new code].
+     Obsolete:   Old code. Something tagged obsolete generally means
+                 it has been replaced by a better system and you
+                 should be using that.
+
+EDK II
+------
+W: https://github.com/tianocore/tianocore.github.io/wiki/EDK-II
+L: https://edk2.groups.io/g/devel/
+T: git - https://github.com/tianocore/edk2-staging.git
+
+Responsible Disclosure, Reporting Security Issues
+-------------------------------------------------
+W: https://github.com/tianocore/tianocore.github.io/wiki/Security
+
+EDK II Packages:
+----------------
+
+EdkRepo Manifest
+W: https://github.com/tianocore/edk2-staging/tree/EdkRepo-Manifest
+M: Nate DeSimone <nathaniel.l.desimone@intel.com>
+M: Ashley DeSimone <ashley.e.desimone@intel.com>
+R: Puja Pandya <puja.pandya@intel.com>
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..2145696afb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+This branch is for integrating the EdkRepo tool manifest XML in to EDK2
+
+# Introduction
+
+EdkRepo is the multi-repository tool for EDK II firmware development. This branch contains an initial set of example manifest files which can be used to try EdkRepo.
+
+# Timeline
+| Time | Event |
+|:----:|:-----:|
+| WW 24 2019 | Initial commit of EdkRepo manifest XML files. |
+|...|...|
+
+# Branch Owners
+- Ashley DeSimone <ashley.e.desimone@intel.com>
+- Nate DeSimone <nathaniel.l.desimone@intel.com>
+
+# Integration
+EdkRepo could live in several places:
+1. edk2-platforms
+2. edk2-pytool-library
+3. The edk2-toolenv repository proposed by Sean (assuming approval of Sean’s RFC)
+4. A new, separate repository created for EdkRepo
+
+This is a topic that requires community discussion to decide what the final location should be.
+
+# Known Issues
+| Issue | Status |
+|:-----:|:------:|
+|...|...|
+
+# Related Links
+- https://github.com/tianocore/edk2-staging/tree/EdkRepo
-- 
2.16.2.windows.1

Re: [PATCH 0/2] EdkRepo - The Multi-Repository Tool for EDK II

[Laszlo Ersek]

Hi Nate,

On 06/12/19 02:04, Nate DeSimone wrote:
> This patch series is raised to add the EdkRepo and EdkRepo-Manifest branches
> to the Edk2-Staging repository. These branches are added to host EdkRepo,
> the multi-repository tool for EDK II firmware development to TianoCore.
> 
> For more details on EdkRepo, please see my RFC.
> 
> Nate DeSimone (2):
>   Add EdkRepo - The Multi-Repo Tool
>   Add EdkRepo manifest XML
> 

the Maintainers.txt files added in both patches contain sections called
"EDK II" and "EDK II Packages". Is that intended? (I'm not familiar with
branches in the staging repo.)

No comments from me otherwise, I'll defer to the other stewards on this.

Thanks!
Laszlo

Re: [edk2-devel] [PATCH 0/2] EdkRepo - The Multi-Repository Tool for EDK II

[Nate DeSimone]

Hi Laszlo,

I wasn't 100% sure on what to do with it myself. I took the existing Maintainers.txt and did the minimal modification necessary to describe EdkRepo. I'm completely flexible with whatever Maintainers.txt format the stewards prefer. If a change is needed let me know and I'll submit a V2 patch series.

Thanks,
Nate 

-----Original Message-----
From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Laszlo Ersek
Sent: Wednesday, June 12, 2019 12:54 AM
To: Desimone, Nathaniel L <nathaniel.l.desimone@intel.com>; devel@edk2.groups.io
Cc: Andrew Fish <afish@apple.com>; Leif Lindholm <leif.lindholm@linaro.org>; Kinney, Michael D <michael.d.kinney@intel.com>
Subject: Re: [edk2-devel] [PATCH 0/2] EdkRepo - The Multi-Repository Tool for EDK II

Hi Nate,

On 06/12/19 02:04, Nate DeSimone wrote:
> This patch series is raised to add the EdkRepo and EdkRepo-Manifest 
> branches to the Edk2-Staging repository. These branches are added to 
> host EdkRepo, the multi-repository tool for EDK II firmware development to TianoCore.
> 
> For more details on EdkRepo, please see my RFC.
> 
> Nate DeSimone (2):
>   Add EdkRepo - The Multi-Repo Tool
>   Add EdkRepo manifest XML
> 

the Maintainers.txt files added in both patches contain sections called "EDK II" and "EDK II Packages". Is that intended? (I'm not familiar with branches in the staging repo.)

No comments from me otherwise, I'll defer to the other stewards on this.

Thanks!
Laszlo

Re: [edk2-devel] [PATCH 0/2] EdkRepo - The Multi-Repository Tool for EDK II

[Michael D Kinney]

Nate,

I agree with Laszlo that the section name in Maintainer.txt
is a bit confusing.  Maybe change "EDK II Packages" section 
title to "Tools" for this initial version.  With that update:

Series Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

Mike

> -----Original Message-----
> From: devel@edk2.groups.io [mailto:devel@edk2.groups.io]
> On Behalf Of Nate DeSimone
> Sent: Tuesday, June 11, 2019 5:05 PM
> To: devel@edk2.groups.io
> Cc: Andrew Fish <afish@apple.com>; Laszlo Ersek
> <lersek@redhat.com>; Leif Lindholm
> <leif.lindholm@linaro.org>; Kinney, Michael D
> <michael.d.kinney@intel.com>
> Subject: [edk2-devel] [PATCH 0/2] EdkRepo - The Multi-
> Repository Tool for EDK II
> 
> This patch series is raised to add the EdkRepo and
> EdkRepo-Manifest branches to the Edk2-Staging repository.
> These branches are added to host EdkRepo, the multi-
> repository tool for EDK II firmware development to
> TianoCore.
> 
> For more details on EdkRepo, please see my RFC.
> 
> Nate DeSimone (2):
>   Add EdkRepo - The Multi-Repo Tool
>   Add EdkRepo manifest XML
> 
> --
> 2.16.2.windows.1
> 
> 
>