[dev][tc][ptl] Evaluating projects in relation to OpenStack cloud vision
As some of you may or may not have heard, recently the Technical Committee approved a technical vision document [1]. The goal of the technical vision document is to try to provide a reference point for cloud infrastructure software in an ideal universe. It is naturally recognized that not all items will apply to all projects. With that in mind, we want to encourage projects to leverage the vision by performing a realistic self-evaluation to determine how their individual project compares to the technical vision: What gaps exist in the project that could be closed to be more in alignment with the vision? Are there aspects of the vision which are inappropriate for the project to such a degree that the vision itself should change, not the project? We envision the results of the evaluation to be added to each project's primary contributor documentation tree (/doc/source/contributor/vision-reflection.rst) as a list of bullet points detailing areas where a project feels they need adjustment to better align with the technical vision, and if the project already has visibility into a path forward, that as well. As with all things of this nature, we anticipate projects to treat the document as a living document and update it as each project's contributors feel necessary. If an individual project community feels something in the overall OpenStack community technical vision does not apply, that is okay. If the project community feels that something in the vision is wrong for the whole of OpenStack, please feel free to submit a revision to gerrit in order to start that discussion. Once projects have performed a realistic self-evaluation, we ask each project to then consider those items they identified in their future planning as areas that could use the attention of contributors. To be very explicit about this, the intent is to help enable projects to identify areas for improved alignment with the rest of OpenStack using a short, concise, easily consumable list that can be referenced in planning, or even by drive-by contributors if they are intrigued by a specific problem. Thanks, Julia Kreger & Chris Dent [1] https://governance.openstack.org/tc/reference/technical-vision.html
Julia and Chris, Thanks for putting this together. Wanted to share some thoughts in-line below: On 1/4/2019 9:53 AM, Julia Kreger wrote:
As some of you may or may not have heard, recently the Technical Committee approved a technical vision document [1].
The goal of the technical vision document is to try to provide a reference point for cloud infrastructure software in an ideal universe. It is naturally recognized that not all items will apply to all projects.
The document is a really good high level view of what each OpenStack project should hopefully conform to. I think it would be good to get this into the Upstream Institute education in some way as I think it is something that new contributors should understand and keep in mind. It certainly would have helped me as a newbie to think about this. <snip>
We envision the results of the evaluation to be added to each project's primary contributor documentation tree (/doc/source/contributor/vision-reflection.rst) as a list of bullet points detailing areas where a project feels they need adjustment to better align with the technical vision, and if the project already has visibility into a path forward, that as well.
</snip> Good idea to have teams go through this. I will work on doing the above for Cinder. Jay
On Mon, Jan 7, 2019 at 1:48 PM Jay Bryant <jungleboyj@gmail.com> wrote: [trim]
<snip>
We envision the results of the evaluation to be added to each project's primary contributor documentation tree (/doc/source/contributor/vision-reflection.rst) as a list of bullet points detailing areas where a project feels they need adjustment to better align with the technical vision, and if the project already has visibility into a path forward, that as well.
</snip>
Good idea to have teams go through this. I will work on doing the above for Cinder.
Jay
Thanks Jay! Putting on my Ironic TL hat for a while, I ended up with a fairly short list [1]. Maybe some naming/words should change, but overall I hope that it kind of gets the level ideas across to a reader. [1]: https://review.openstack.org/#/c/629060/
On 8/01/19 10:43 AM, Jay Bryant wrote:
Julia and Chris,
Thanks for putting this together. Wanted to share some thoughts in-line below:
On 1/4/2019 9:53 AM, Julia Kreger wrote:
As some of you may or may not have heard, recently the Technical Committee approved a technical vision document [1].
The goal of the technical vision document is to try to provide a reference point for cloud infrastructure software in an ideal universe. It is naturally recognized that not all items will apply to all projects.
The document is a really good high level view of what each OpenStack project should hopefully conform to. I think it would be good to get this into the Upstream Institute education in some way as I think it is something that new contributors should understand and keep in mind. It certainly would have helped me as a newbie to think about this.
I love this idea. Looking at https://docs.openstack.org/upstream-training/ it seems that the syllabus for Upstream Institute is (or will eventually be) effectively the Contributor Guide, so a good first step would be to link to the vision from the Contributor Guide: https://review.openstack.org/631366 Any idea what else would be involved in making this happen? thanks, Zane.
<snip>
We envision the results of the evaluation to be added to each project's primary contributor documentation tree (/doc/source/contributor/vision-reflection.rst) as a list of bullet points detailing areas where a project feels they need adjustment to better align with the technical vision, and if the project already has visibility into a path forward, that as well.
</snip>
Good idea to have teams go through this. I will work on doing the above for Cinder.
Jay
I love this idea.
Looking at https://docs.openstack.org/upstream-training/ it seems that the syllabus for Upstream Institute is (or will eventually be) effectively the Contributor Guide, so a good first step would be to link to the vision from the Contributor Guide: https://review.openstack.org/631366
Any idea what else would be involved in making this happen?
thanks, Zane.
Zane, I help with OUI so I can make sure when we do the next review of things that we include this in the syllabus. Thanks! Jay
participants (3)
-
Jay Bryant
-
Julia Kreger
-
Zane Bitter