Re: [steering-discuss] Candidacy for Board: Michael Meeks

2011-10-10 Thread Tom Davies
Hi :)
Thanks :)  I'm not going to be at Paris but thanks for the offer.  

Documentation on how to join in with other teams (including the Docs Team 
(following recent upgrades to their infrastructure)) also needs to be done.  

I don't know what UNO is.  It seems to be something that depends on javascript 
or .Net or something??  Seems a bit strange.  Of the links i found this link 
made the most sense 
http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/FirstSteps/Programming_with_UNO
and even that was a tad confusing imo.  Does the limited guidance on how to add 
a language or new translation push people into using UNO?  

Oddly we don't get many calls for how to translate or how to add a new language 
and when we do people seem satisfied with the links we give them to specific 
teams or to the global translations list.  We do need to get decent guides for 
those things but we get a lot more people asking about how to join in with 
programming and people seldom seem happy with what we can give them.  

It would be good to have a proper LO Guide that reflects LO's direction instead 
of the direction under Sun.  

If there are other guides that could be usefully added to the collection that 
would be great.  Anyone can either edit the page or pass the links to the 
documentation list.  

Anyway, thanks hugely for your considerate reply.  
Regards from
Tom :)



--- On Mon, 10/10/11, Michael Meeks michael.me...@suse.com wrote:

From: Michael Meeks michael.me...@suse.com
Subject: Re: [steering-discuss] Candidacy for Board: Michael Meeks
To: steering-discuss@documentfoundation.org
Date: Monday, 10 October, 2011, 10:11

Hi Tom,

On Sat, 2011-10-08 at 18:02 +0100, Tom Davies wrote:
 One of the top priorities for the Documentation Team right now
 is a guide to help people that want to start programming for
 LibreOffice.  

    Cool ! :-) and of course, it's something that can be dead useful. 

 There is already a good one for Extensions 

    Right - and of course, we'd prefer people to write code that can be
integrated into the core cleanly, and have code sharing between
different implementations (it's easier to hack that up, debug it, and
deploy it too FWIW).

 At the moment the Docs Team can only point to
 http://wiki.documentfoundation.org/Documentation#Other_Documentation_and_Resources

    I like the collection; it'd be great to excerpt / re-write some more
functionally focused flows for the things we know happen lots:

    How to add a new language
    How to add a new translation

    But of course many things are simply not documented at all; and worse
most of the existing docs are *heavily* UNO focused, which is (IMHO) a
big mistake.

    Anyhow - there were some starter tasks I mentioned to David, when
they're done - lets have a call  brainstorm on what more can be done,
and how best to do it; will you be in Paris to discuss ?

    I suspect there is enough out there to dig out and re-hash in a helpful
way. As an example if we systematically discard anything that talks
about UNO - and condense what little is left (code structure diagrams /
functional descriptions etc.) I think we might end up with something
quite useful for new core hackers: or at least a nucleus to work from.

    Thanks,

        Michael.

-- 
michael.me...@suse.com  , Pseudo Engineer, itinerant idiot


-- 
Unsubscribe instructions: E-mail to steering-discuss+h...@documentfoundation.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.documentfoundation.org/www/steering-discuss/
All messages sent to this list will be publicly archived and cannot be deleted

-- 
Unsubscribe instructions: E-mail to steering-discuss+h...@documentfoundation.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.documentfoundation.org/www/steering-discuss/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [steering-discuss] Candidacy for Board

2011-10-10 Thread David Nelson
Hi Michael,

On Mon, Oct 10, 2011 at 1:50 PM, Michael Meeks michael.me...@suse.com wrote:
 On Sun, 2011-10-09 at 12:22 +0300, David Nelson wrote:
 Your arguments resound with the sideways logic and suave patter of a
 dishonest used car salesman combined with the moral values of a
 larcenous banker. :-D

        This is totally out of line; even with a smile. Tone is really
 important to attracting and retaining developers - far more so than
 documentation, and this -really- lowers it.

That was a *joke*. Failed apparently. I must remember that humor
doesn't work on these mailing lists. :-( However, I'm sorry you didn't
seriously reply to the many serious and (IMHO) valid points I made...

-- 
David Nelson

-- 
Unsubscribe instructions: E-mail to steering-discuss+h...@documentfoundation.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.documentfoundation.org/www/steering-discuss/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [steering-discuss] Candidacy for Board: Michael Meeks

2011-10-10 Thread David Nelson
Hi Michael,

Thanks for the answers. I don't have time to reply in detail this
week, but I will certainly be thinking about what you said. I don't
intend to let go of this subject, but will be planning my next
attack (let me register that as a joke already) on the discuss list.
I'll be coming up with a concrete plan, and this will certainly take
account of your kind suggestions above.

Read you around, and have a good time at the conference. ;-)

-- 
David Nelson

-- 
Unsubscribe instructions: E-mail to steering-discuss+h...@documentfoundation.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.documentfoundation.org/www/steering-discuss/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [steering-discuss] Candidacy for Board: Michael Meeks

2011-10-10 Thread David Nelson
Sorry, I just want to add this small comment/question to my preceding
posts in this thread:

I have been searching around, and I have not been able to find an
official development roadmap of any kind. For sure, there's detailed
information about planned release dates going far into the future [1].

But I don't find any information about what changes are planned to the
general architecture of LibreOffice.

If our leading devs stopped coding on LibreOffice tomorrow, not only
would we not have any design documentation explaining how the beast is
architectured and how it works, but we wouldn't have any idea of what
kind of future plans they'd been working on implementing, and how far
they'd advanced in the process.

Does the engineering steering committee have any kind of formal
methodologies, and any kind of formal documents that it maintains?

Or is the future of LibreOffice simply stored in a myriad of post-its
on your computer monitors, and in your minds, and in a tenuous web of
discussion threads on the devs mailing list?

-- 
David Nelson

-- 
Unsubscribe instructions: E-mail to steering-discuss+h...@documentfoundation.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.documentfoundation.org/www/steering-discuss/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [steering-discuss] Candidacy for Board: Michael Meeks

2011-10-10 Thread David Nelson
On Mon, Oct 10, 2011 at 3:40 PM, David Nelson li...@traduction.biz wrote:
 For sure, there's detailed
 information about planned release dates going far into the future [1].

[1] http://wiki.documentfoundation.org/ReleasePlan

-- 
David Nelson

-- 
Unsubscribe instructions: E-mail to steering-discuss+h...@documentfoundation.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.documentfoundation.org/www/steering-discuss/
All messages sent to this list will be publicly archived and cannot be deleted



Re: [tdf-discuss] Re: [steering-discuss] Candidacy for Board: Michael Meeks

2011-10-10 Thread David Nelson
Hi Michael,

Thank you for taking time out to give me those interesting answers.
Lots of food for thought there, as has been the case in the past after
discussing with you.

I'll be arming up for work on the online help and the code base in the
near future, and will pop up on IRC at that time. And I'll be coming
back to the subject of design docs on the discuss list, with ideas and
questions.

Again, thanks for the time, and have a good conference. :-) I so much
regret I won't be there with you guys.

-- 
David Nelson

-- 
Unsubscribe instructions: E-mail to steering-discuss+h...@documentfoundation.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.documentfoundation.org/www/steering-discuss/
All messages sent to this list will be publicly archived and cannot be deleted