vote on PRD
drieden at redhat.com
Thu Jan 16 20:17:18 UTC 2014
----- Original Message -----
> From: "Tadej Janež" <tadej.janez at tadej.hicsalta.si>
> To: env-and-stacks at lists.fedoraproject.org
> Sent: Thursday, January 16, 2014 1:13:15 PM
> Subject: Re: vote on PRD
> On Thu, 2014-01-16 at 16:20 +0100, Marcela Mašláňová wrote:
> > Guys,
> > I'd like to ask you to vote about current PRD. The deadline is on
> > Monday. Do you want to vote on it tomorrow (Friday)?
> Yes, I'm for voting tomorrow since the deadline is on Monday.
This sounds good to me.
> I've made some final changes to the PRD. Please see the latest version.
> Some things that I still feel we should improve:
> 1) Remove the "Reviewers & Contributors" and "Tracking of Progress"
> sections. Maybe also the "Community Information" and "Document History"
> sections, since I don't see what they bring to the PRD.
I think the "Reviewers" section is important since we should have this reviewed
by our group as well as others. Listing who has reviewed the document and if they are on board with it or not, as well as capturing their comments, is important. Perhaps it can be a separate page if it gets too big.
The "Tracking of Progress" is a good idea, but not sure if it belongs in the PRD.
I'm also for removing the "Document History", since you can get the history from the history tab.
I have no opinion on "Community Information".
> 2) Improve the SCL section by reaching some consensus.
Yes, and it would really help to have a definition of what "scl-utils" is and why it would be used or where to get more information on it. This section seems a little light on content.
> 3) Make a distinction between more important tasks/goals and those we
> see as less important.
This is a good idea. This can help with a schedule.
Also as people review the document, if they find that something is more important or less important, it can be considered.
> We should also ask for input of the wider Fedora community by announcing
> our final PRD draft on devel-announce, like other WG.
I agree with this too.
All good suggestions.
The PRD is looking good and has come a long way in a short time.
One question to ask ourselves is what is someone going to do with this PRD?
Have we provided everything they need to use the PRD as intended?
Since this is described in the "What this document describes" section, could
we add the word "Purpose" to this title? Not to be nit picky, but this section is titled "Document Purpose and Overview" and there isn't anything labelled "Purpose" or "Overview". It seems like Overview encompasses "Vision Statement", "Mission Statement" and "Definitions and Acronyms", while Purpose is the "What this document describes" section.
Otherwise, looks good!
> env-and-stacks mailing list
> env-and-stacks at lists.fedoraproject.org
Engineering Program Manager
(Developer Toolset (DTS), Software Collections (RHSCL), LPC Pilot and some other projects)
Office: 978-392-1023; Cell 617-669-2934
drieden at redhat.com
#devtoolset, #boston, #software-collections
More information about the env-and-stacks