On 30/04/2011, at 5:45 AM, Tom Davies <tomdavie...@yahoo.co.uk> wrote:

> Hi :)
> I have been worrying about there not being enough people doing the actual 
> work 
> in LibreOffice Documentation Team, particularly since finding that 2 of the 
> hardest workers are in fact just 1 person!
> 
> I was wondering about putting a call out to the Ubuntu Documentation Team to 
> see 
> if we could attract a couple of them over here?  They have just been 
> exploring 
> different tools for writing documentation and settled on Mallard a few months 
> ago.  I don't think Alfresco came up in their discussions.  Is Alfresco 
> similar 
> enough to Mallard to make transition easy for them if they join us/you?  Now 
> we 
> have documentation about using Alfresco it should be easier for them and 
> anyway 
> Alfresco looks intuitive enough that they should be able to "get it" with 
> gentle 
> nudges?
> 
> Would it be too cheeky to ask them?  It would probably help them to work at 
> documentation upstream, here.  Their translation teams are often encouraged 
> to 
> work upstream but those teams don't seem to work closely with their 
> documentation team but they might be familiar with the idea, maybe.


Another good potential source of members is the OOo docs team, who have the 
advantage of being familiar with the base product. They may not want to make 
the switch from the ODFAuthors platform to Alfresco, but to me that's a trivial 
difference of tools. If it's a show stopper for anyone, there are ways around 
the problem. IMO, we should not let our choice of platform dictate who can 
participate, if they are otherwise interested and capable. 

Also, I strongly believe (based on positive experience with OOo docs) that 
people who are not native English speakers can be extremely valuable members of 
the English team. The only place where native speakers may have an advantage is 
at the copy editing stage (which some incorrectly call proofreading). The 
biggest lack IMO is people who can and will do reviews for content accuracy, 
and high English skills are not necessary for that work. IMO we should be 
encouraging these people to participate, not discouraging them.

Lastly, we need more than just user guides, and not all of our docs needs are 
best managed through Alfresco. For example, FAQs may be better managed on the 
wiki, and in the past assistance had been requested for website text. 

As for the Ubuntu docs people, I don't think it's cheeky to ask them.

--Jean
-- 
Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/www/documentation/
All messages sent to this list will be publicly archived and cannot be deleted

Reply via email to