Hi Alan, Thanks for your response :) I hope you don't mind, I'm replying back to you and the openstack-discuss list so the other TC members also working on the Help Most Wanted text can review your thoughts. In the etherpad, you can just start writing and it will give you an individual colour assigned to your user. If you feel like we won't see/know who you are, just put your initials next to your comments :) Thanks so much for offering to help. I've transferred over your thoughts below into the etherpad for now. Thanks, Alex On 13/06/2019 00:14, Alan Clark wrote:

Hey Alexandra,

As I mentioned during the TC meeting I would love to help with the "Help Most Wanted" text.

I took a look at the etherpad for the documentation role [1]

I would like to offer a couple suggested changes. I wasn't sure where to post them, so am pinging you directly.

My first comment is around the audience. Who is most likely to fit and fill this role. I think the audience we are after for this posting are those that take the OpenStack documentation to develop for re-use and distribution. Those are the most likely persons to convince to take a higher contribution and leadership role. Which is what this posting targets.

The opening description section conveys the documentation teams pain and struggles. I think a more effective opening would be to convey the business and personal benefits the audience gains from contributing. They have to sell this to their boss. Boss wants to solve their pain not the documentation teams. If we agree that the most likely audience to contribute in this posted role, then their benefits are more complete documentation with less effort. Being able to leverage and re-use the community contributed text means much less text that the audience person has to write. Helping the community effort helps steer the contributed text to fill the needs and gaps that you find of most need. The first paragraph starts in the right direction but I suggest replacing the second paragraph with these ideas. I’m sure you can elaborate these ideas better than me.

My second thought is that this posting should convey that it’s easy to do and get started. In fact you could turn it into an FAQ style. The First timers page is full of great material and a good page to point to: https://docs.openstack.org/doc-contrib-guide/quickstart/first-timers.html Address the question of how easy it is to get started, that they use the tools they commonly use and here’s where to get their questions and concerns answered.

Thanks, AlanClark

[1] https://etherpad.openstack.org/p/2019-upstream-investment-opportunities-refa...

...

-----Original Message----- From: Alexandra Settle [mailto:a.settle@outlook.com] Sent: Thursday, June 06, 2019 9:51 AM To: openstack-discuss@lists.openstack.org Subject: [tc] Recap for Technical Committee Meeting 6 June 2019 @ 1400 UTC

Hello all,

Thanks to those who joined the TC meeting today and running through it with me at the speed of light. Gif game was impeccably strong and that's primarily what I like about this community.

For a recap of the meeting, please see the eavesdrop [0] for full detailed logs and action items. All items in the agenda [1] were covered and no major concerns raised.

Next meeting will be on the 8th of July 2019.

Cheers,

Alex

[0] http://eavesdrop.openstack.org/meetings/tc/2019/tc.2019-06-06-14.00.txt

[1] http://lists.openstack.org/pipermail/openstack-discuss/2019-June/006877.html