Community involvement - brainstorming

Alberto Salvia Novella es20490446e at gmail.com
Sun Aug 23 12:10:05 UTC 2015


Elizabeth K. Joseph:
 > https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/DocumentStructure

Although this guide provides some important information, I think this is 
not the kind of information we need. Not a guide that focuses on writing 
correctly, but on helping providing a document structure that is both 
functional and appealing.

And you can see that part is already missed since 2008:
<https://wiki.ubuntu.com/DocumentationTeam/StyleGuide/DocumentStructure>


Elizabeth K. Joseph:
 > Having sprint-specific gatherings once a month too it may be
 > worthwhile, but we'd need someone to step up to lead those and hope
 > they'd be more well attended than our meetings :)

I have the suspicion that the reason why people don't attend these 
meetings is they are unwilling to expend an hour when there's no clear 
evidence that something relevant needs discussion. Still they liked to 
speak with the team from time to time.

So after reading a bit about meetings, something popped in my mind. What 
if meetings just lasted 30 minutes?

We could make those simply with the frequency needed for keeping the 
team in touch, and to miss some attendance with no problem. Lets say two 
weeks. We can even schedule them in different time frames in each 
occasion, so it fits more people while avoiding the extra work of having 
multiple sessions.


Elizabeth K. Joseph:
 > I can't participate in video meetings because I'm at work (IRC is ok,
 > since I can look in and catch up). Even more frustrating, there is no
 > log for me to quickly review for important bits after.

Oh, then that is a good reason to take into consideration. On the other 
hand I know of some teams that take notes during the meeting, and make a 
summary about it at the end.


Elizabeth K. Joseph:
 > We've done a lot of work over the past couple of years to improve and
 > make sure https://wiki.ubuntu.com/DocumentationTeam is up to date.
 > It's also linked clearly on the community website with its own
 > section: http://community.ubuntu.com/contribute/documentation/

That's what I meant ;)

Nevertheless I joined this team not for writing documentation in 
general, but for writing specifically documentation about quality assurance.

I though that joining people that are used to writing documentation 
would help on improving my own style. So perhaps we could focus on that 
kind of people too, people that just want to improve their doc writing 
style in their specific areas, and to reflect that in those pages.

Have a nice day ;)


-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 6472 bytes
Desc: S/MIME Cryptographic Signature
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20150823/3631a6f3/attachment.bin>


More information about the ubuntu-doc mailing list