Re: [openstack-dev] [docs] Evidence of Success

2017-10-27 Thread Petr Kovar 
On Tue, 17 Oct 2017 17:27:10 +0200
Petr Kovar  wrote:

> Thanks for your feedback, everybody. I made some more edits to the
> document and tried to address the remaining comments left in the etherpad.
> 
> I think the current revision of the doc provides enough details on
> the metrics and goals, so it should be ready to be added to
> https://docs.openstack.org/doc-contrib-guide/ as an official project doc.
> Let us know if you have more comments. 

Just a quick update that a final review of the vision document can be found
here:

https://review.openstack.org/#/c/514779/

Would be good to get move votes from the docs team and the community,
so please have a look.

Thanks,
pk

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Re: [openstack-dev] [docs] Evidence of Success

2017-10-17 Thread Petr Kovar 
Thanks for your feedback, everybody. I made some more edits to the
document and tried to address the remaining comments left in the etherpad.

I think the current revision of the doc provides enough details on
the metrics and goals, so it should be ready to be added to
https://docs.openstack.org/doc-contrib-guide/ as an official project doc.
Let us know if you have more comments. 

Cheers,
pk


On Mon, 09 Oct 2017 16:35:57 -0400
Doug Hellmann  wrote:

> This draft looks really good. I left a few comments on the etherpad.
> 
> Excerpts from Jimmy McArthur's message of 2017-10-05 10:33:48 -0500:
> > Sorry for the Google Docs link btw. That's where Petr and I were 
> > initially collaborating. I've moved this back to the etherpad referenced 
> > in ttps://etherpad.openstack.org/p/docs-i18n-ptg-queens 
> > 
> > 
> > https://etherpad.openstack.org/p/docs-i18n-ptg-queens-mission-statement
> > 
> > > Jimmy McArthur 
> > > October 4, 2017 at 1:18 PM
> > >
> > >
> > >> Emilien Macchi 
> > >> October 4, 2017 at 12:35 PM
> > >>
> > >> The draft is really good! It reflects very well what we said we would
> > >> do at the PTG, way to go.
> > >>
> > >> I think the next steps would be:
> > >> - Definition of Done, or how you consider something achieved (code
> > >> merged, doc published, etc).
> > >> - Metrics: what metrics do you use to measure what you're delivering.
> > > For the DoD and Metrics our understanding of the task was that they 
> > > should be built into the Evidence of Success, though I think we could 
> > > still use some more specific metrics in certain spots.  Emilien, would 
> > > you suggest we define these as separate line items as well?
> > >
> > > Thanks!
> > > Jimmy
> > >> - What do you expect by end of Queens (put some number in metrics is
> > >> probably a good start) - it's already mentioned in your draft vision
> > >> but it might be revisited once you define the 2 previous items.
> > >>
> > >> Good work!
> > >> Jimmy McArthur 
> > >> October 4, 2017 at 10:46 AM
> > >> I've made a bit of progress on the collaborative vision for the Docs 
> > >> team: 
> > >> https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit#
> > >>  
> > >>
> > >>
> > >> This still needs plenty of work, but I wanted to put out what we have 
> > >> so we can start to get some feedback from other members of the Docs 
> > >> team. The Use Cases section in particular was really vast and hard to 
> > >> cut down into prose without getting too detailed.
> > >>
> > >> Welcome your feedback and input!
> > >>
> > >> Thanks,
> > >> Jimmy
> > >>
> > >>
> > >>
> > >> __
> > >>  
> > >>
> > >> OpenStack Development Mailing List (not for usage questions)
> > >> Unsubscribe: 
> > >> openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
> > >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> > >
> > > __
> > > OpenStack Development Mailing List (not for usage questions)
> > > Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
> > > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> > > Emilien Macchi 
> > > October 4, 2017 at 12:35 PM
> > >
> > > The draft is really good! It reflects very well what we said we would
> > > do at the PTG, way to go.
> > >
> > > I think the next steps would be:
> > > - Definition of Done, or how you consider something achieved (code
> > > merged, doc published, etc).
> > > - Metrics: what metrics do you use to measure what you're delivering.
> > > - What do you expect by end of Queens (put some number in metrics is
> > > probably a good start) - it's already mentioned in your draft vision
> > > but it might be revisited once you define the 2 previous items.
> > >
> > > Good work!
> > > Jimmy McArthur 
> > > October 4, 2017 at 10:46 AM
> > > I've made a bit of progress on the collaborative vision for the Docs 
> > > team: 
> > > https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit#
> > >  
> > >
> > >
> > > This still needs plenty of work, but I wanted to put out what we have 
> > > so we can start to get some feedback from other members of the Docs 
> > > team. The Use Cases section in particular was really vast and hard to 
> > > cut down into prose without getting too detailed.
> > >
> > > Welcome your feedback and input!
> > >
> > > Thanks,
> > > Jimmy
> > >
> > >
> > >
> > > __
> > >  
> > >
> > > OpenStack Development Mailing List (not for usage questions)
> > > Unsubscribe: 
> > > openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
> > > http://lists.openstack.or

Re: [openstack-dev] [docs] Evidence of Success

2017-10-09 Thread Doug Hellmann 
This draft looks really good. I left a few comments on the etherpad.

Excerpts from Jimmy McArthur's message of 2017-10-05 10:33:48 -0500:
> Sorry for the Google Docs link btw. That's where Petr and I were 
> initially collaborating. I've moved this back to the etherpad referenced 
> in ttps://etherpad.openstack.org/p/docs-i18n-ptg-queens 
> 
> 
> https://etherpad.openstack.org/p/docs-i18n-ptg-queens-mission-statement
> 
> > Jimmy McArthur 
> > October 4, 2017 at 1:18 PM
> >
> >
> >> Emilien Macchi 
> >> October 4, 2017 at 12:35 PM
> >>
> >> The draft is really good! It reflects very well what we said we would
> >> do at the PTG, way to go.
> >>
> >> I think the next steps would be:
> >> - Definition of Done, or how you consider something achieved (code
> >> merged, doc published, etc).
> >> - Metrics: what metrics do you use to measure what you're delivering.
> > For the DoD and Metrics our understanding of the task was that they 
> > should be built into the Evidence of Success, though I think we could 
> > still use some more specific metrics in certain spots.  Emilien, would 
> > you suggest we define these as separate line items as well?
> >
> > Thanks!
> > Jimmy
> >> - What do you expect by end of Queens (put some number in metrics is
> >> probably a good start) - it's already mentioned in your draft vision
> >> but it might be revisited once you define the 2 previous items.
> >>
> >> Good work!
> >> Jimmy McArthur 
> >> October 4, 2017 at 10:46 AM
> >> I've made a bit of progress on the collaborative vision for the Docs 
> >> team: 
> >> https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit#
> >>  
> >>
> >>
> >> This still needs plenty of work, but I wanted to put out what we have 
> >> so we can start to get some feedback from other members of the Docs 
> >> team. The Use Cases section in particular was really vast and hard to 
> >> cut down into prose without getting too detailed.
> >>
> >> Welcome your feedback and input!
> >>
> >> Thanks,
> >> Jimmy
> >>
> >>
> >>
> >> __ 
> >>
> >> OpenStack Development Mailing List (not for usage questions)
> >> Unsubscribe: 
> >> openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> >
> > __
> > OpenStack Development Mailing List (not for usage questions)
> > Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> > Emilien Macchi 
> > October 4, 2017 at 12:35 PM
> >
> > The draft is really good! It reflects very well what we said we would
> > do at the PTG, way to go.
> >
> > I think the next steps would be:
> > - Definition of Done, or how you consider something achieved (code
> > merged, doc published, etc).
> > - Metrics: what metrics do you use to measure what you're delivering.
> > - What do you expect by end of Queens (put some number in metrics is
> > probably a good start) - it's already mentioned in your draft vision
> > but it might be revisited once you define the 2 previous items.
> >
> > Good work!
> > Jimmy McArthur 
> > October 4, 2017 at 10:46 AM
> > I've made a bit of progress on the collaborative vision for the Docs 
> > team: 
> > https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit#
> >  
> >
> >
> > This still needs plenty of work, but I wanted to put out what we have 
> > so we can start to get some feedback from other members of the Docs 
> > team. The Use Cases section in particular was really vast and hard to 
> > cut down into prose without getting too detailed.
> >
> > Welcome your feedback and input!
> >
> > Thanks,
> > Jimmy
> >
> >
> >
> > __ 
> >
> > OpenStack Development Mailing List (not for usage questions)
> > Unsubscribe: 
> > openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Re: [openstack-dev] [docs] Evidence of Success

2017-10-05 Thread Jimmy McArthur 
Sorry for the Google Docs link btw. That's where Petr and I were 
initially collaborating. I've moved this back to the etherpad referenced 
in ttps://etherpad.openstack.org/p/docs-i18n-ptg-queens 



https://etherpad.openstack.org/p/docs-i18n-ptg-queens-mission-statement


Jimmy McArthur 
October 4, 2017 at 1:18 PM



Emilien Macchi 
October 4, 2017 at 12:35 PM

The draft is really good! It reflects very well what we said we would
do at the PTG, way to go.

I think the next steps would be:
- Definition of Done, or how you consider something achieved (code
merged, doc published, etc).
- Metrics: what metrics do you use to measure what you're delivering.
For the DoD and Metrics our understanding of the task was that they 
should be built into the Evidence of Success, though I think we could 
still use some more specific metrics in certain spots.  Emilien, would 
you suggest we define these as separate line items as well?


Thanks!
Jimmy

- What do you expect by end of Queens (put some number in metrics is
probably a good start) - it's already mentioned in your draft vision
but it might be revisited once you define the 2 previous items.

Good work!
Jimmy McArthur 
October 4, 2017 at 10:46 AM
I've made a bit of progress on the collaborative vision for the Docs 
team: 
https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit# 



This still needs plenty of work, but I wanted to put out what we have 
so we can start to get some feedback from other members of the Docs 
team. The Use Cases section in particular was really vast and hard to 
cut down into prose without getting too detailed.


Welcome your feedback and input!

Thanks,
Jimmy



__ 


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: 
openstack-dev-requ...@lists.openstack.org?subject:unsubscribe

http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Emilien Macchi 
October 4, 2017 at 12:35 PM

The draft is really good! It reflects very well what we said we would
do at the PTG, way to go.

I think the next steps would be:
- Definition of Done, or how you consider something achieved (code
merged, doc published, etc).
- Metrics: what metrics do you use to measure what you're delivering.
- What do you expect by end of Queens (put some number in metrics is
probably a good start) - it's already mentioned in your draft vision
but it might be revisited once you define the 2 previous items.

Good work!
Jimmy McArthur 
October 4, 2017 at 10:46 AM
I've made a bit of progress on the collaborative vision for the Docs 
team: 
https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit# 



This still needs plenty of work, but I wanted to put out what we have 
so we can start to get some feedback from other members of the Docs 
team. The Use Cases section in particular was really vast and hard to 
cut down into prose without getting too detailed.


Welcome your feedback and input!

Thanks,
Jimmy



__ 


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: 
openstack-dev-requ...@lists.openstack.org?subject:unsubscribe

http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Re: [openstack-dev] [docs] Evidence of Success

2017-10-05 Thread Emilien Macchi 
On Wed, Oct 4, 2017 at 11:18 AM, Jimmy McArthur  wrote:
[...]

> For the DoD and Metrics our understanding of the task was that they should
> be built into the Evidence of Success, though I think we could still use
> some more specific metrics in certain spots.  Emilien, would you suggest we
> define these as separate line items as well?

[...]

No, I think it's good as it is now, good work!
-- 
Emilien Macchi

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Re: [openstack-dev] [docs] Evidence of Success

2017-10-04 Thread Jimmy McArthur 




Emilien Macchi 
October 4, 2017 at 12:35 PM

The draft is really good! It reflects very well what we said we would
do at the PTG, way to go.

I think the next steps would be:
- Definition of Done, or how you consider something achieved (code
merged, doc published, etc).
- Metrics: what metrics do you use to measure what you're delivering.
For the DoD and Metrics our understanding of the task was that they 
should be built into the Evidence of Success, though I think we could 
still use some more specific metrics in certain spots.  Emilien, would 
you suggest we define these as separate line items as well?


Thanks!
Jimmy

- What do you expect by end of Queens (put some number in metrics is
probably a good start) - it's already mentioned in your draft vision
but it might be revisited once you define the 2 previous items.

Good work!
Jimmy McArthur 
October 4, 2017 at 10:46 AM
I've made a bit of progress on the collaborative vision for the Docs 
team: 
https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit# 



This still needs plenty of work, but I wanted to put out what we have 
so we can start to get some feedback from other members of the Docs 
team. The Use Cases section in particular was really vast and hard to 
cut down into prose without getting too detailed.


Welcome your feedback and input!

Thanks,
Jimmy



__ 


OpenStack Development Mailing List (not for usage questions)
Unsubscribe: 
openstack-dev-requ...@lists.openstack.org?subject:unsubscribe

http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Re: [openstack-dev] [docs] Evidence of Success

2017-10-04 Thread Emilien Macchi 
On Wed, Oct 4, 2017 at 8:46 AM, Jimmy McArthur  wrote:
> I've made a bit of progress on the collaborative vision for the Docs team:
> https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit#
>
> This still needs plenty of work, but I wanted to put out what we have so we
> can start to get some feedback from other members of the Docs team. The Use
> Cases section in particular was really vast and hard to cut down into prose
> without getting too detailed.
>
> Welcome your feedback and input!

The draft is really good! It reflects very well what we said we would
do at the PTG, way to go.

I think the next steps would be:
- Definition of Done, or how you consider something achieved (code
merged, doc published, etc).
- Metrics: what metrics do you use to measure what you're delivering.
- What do you expect by end of Queens (put some number in metrics is
probably a good start) - it's already mentioned in your draft vision
but it might be revisited once you define the 2 previous items.

Good work!
-- 
Emilien Macchi

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

[openstack-dev] [docs] Evidence of Success

2017-10-04 Thread Jimmy McArthur 
I've made a bit of progress on the collaborative vision for the Docs 
team: 
https://docs.google.com/document/d/1Xy78CnmnKlQ7SbR1XewqgrUdGe7DqnKAGYw_9aj5Ndg/edit#


This still needs plenty of work, but I wanted to put out what we have so 
we can start to get some feedback from other members of the Docs team. 
The Use Cases section in particular was really vast and hard to cut down 
into prose without getting too detailed.


Welcome your feedback and input!

Thanks,
Jimmy



__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev