[libreoffice-documentation] Re: [Libreoffice] LibreOffice WikiHelp
Hi, :-) I suppose that logically this is something for the documentation team to get involved in... We're having a phone conference this weekend... Shall I add it to the agenda? If you need a docs person to liaise with about this, please feel free to include me in the loop. David Nelson On Fri, Nov 26, 2010 at 16:00, Jan Holesovsky ke...@suse.cz wrote: Hi Christian, On 2010-11-25 at 22:24 +0100, Christian Lohmaier wrote: Hm... how will the help be exported? What's easiest for you? MediaWiki, any other interface? The question is whether you want people to just read the content there, or whether you want people to update content. I'd say: provide only readonly access, maybe with a commenting feature, but keep the editing to pootle. Let me actually take this to the ML, because this is a really good question, and I probably did not explain much about the WikiHelp so far. So first - what is WikiHelp? It is going to be a help.libreoffice.org site, where the LibreOffice help will be stored. The intention is that it will be a Wiki - because the Wiki concept and format is widely used for information exchange, and because it is so easy to edit and improve. For the first cut, it will be read-only, to debug the converter; I'll announce it in a few days for feedback + testing. In the long run [around LibreOffice final ;-)], we should allow editing there when 'good enough', so that the wikihelp becomes the source of the help for LibreOffice, instead of the xhp files. I am still doing the final experiments there, but the hope is that I'll get it to the state where the developer can just commit code that should have some help, provide a stub article, and the first time a user hits that, she/he can update it with more information. And the off-line (installed) help will be generated from this wikihelp in the next releases. Additionally, thanks to wiki being versioned, we will still be able to merge changes from OOo. I can imagine that getting the help files into a wiki require some manual work, so we should chose the web interface that's easiest for us to use. :-) Simplest would probably just a small xstl conversion to html of the application help files. The tooling is now written, just needs testing and polishing: cd clone/help/helpcontent2 ./help-to-wiki.py And you'll see the current result in a wiki/ subdir. Whoever interested in this - patches appreciated! :-) Regards, Kendy ___ LibreOffice mailing list libreoff...@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/libreoffice -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://www.libreoffice.org/lists/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: Fwd: [libreoffice-documentation] Documentation conference call
Hi, :-) I added an item about the upcoming WikiHelp site (help.libreoffice.org) to the agenda [1], entering the charts at number 14. ;-) [1] http://wiki.documentfoundation.org/Documentation/ConfCalls#Agenda David Nelson -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://www.libreoffice.org/lists/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: Fwd: [libreoffice-documentation] Documentation conference call
I have never used this system before. I am calling within Australia to the dial-in number given for Australia. Do I need to use the full 11-digit number (including the country code) or can I just call the usual area code + phone number that I use for normal calls within the country? Same question would apply, I guess to anyone calling the number for their own country. I know that some services do require the country code even from within the country; that's why I'm asking. And indeed I'm not sure how one includes the country code when calling from within the same country, when using a landline. Nor can I be bothered to find out unless I have to. Can you tell I don't use phones much? ;-) --Jean -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://www.libreoffice.org/lists/documentation/ *** All posts to this list are publicly archived for eternity ***
[libreoffice-documentation] unsubscribe
-- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://www.libreoffice.org/lists/documentation/ *** All posts to this list are publicly archived for eternity ***
Re: [libreoffice-documentation] Re: [Libreoffice] LibreOffice WikiHelp
On Fri, Nov 26, 2010 at 6:14 PM, David Nelson comme...@traduction.biz wrote: Hi, :-) I suppose that logically this is something for the documentation team to get involved in... We're having a phone conference this weekend... Shall I add it to the agenda? If you need a docs person to liaise with about this, please feel free to include me in the loop. David Nelson On Fri, Nov 26, 2010 at 16:00, Jan Holesovsky ke...@suse.cz wrote: Hi Christian, On 2010-11-25 at 22:24 +0100, Christian Lohmaier wrote: Hm... how will the help be exported? What's easiest for you? MediaWiki, any other interface? The question is whether you want people to just read the content there, or whether you want people to update content. I'd say: provide only readonly access, maybe with a commenting feature, but keep the editing to pootle. Let me actually take this to the ML, because this is a really good question, and I probably did not explain much about the WikiHelp so far. So first - what is WikiHelp? It is going to be a help.libreoffice.org site, where the LibreOffice help will be stored. The intention is that it will be a Wiki - because the Wiki concept and format is widely used for information exchange, and because it is so easy to edit and improve. For the first cut, it will be read-only, to debug the converter; I'll announce it in a few days for feedback + testing. In the long run [around LibreOffice final ;-)], we should allow editing there when 'good enough', so that the wikihelp becomes the source of the help for LibreOffice, instead of the xhp files. I am still doing the final experiments there, but the hope is that I'll get it to the state where the developer can just commit code that should have some help, provide a stub article, and the first time a user hits that, she/he can update it with more information. And the off-line (installed) help will be generated from this wikihelp in the next releases. Additionally, thanks to wiki being versioned, we will still be able to merge changes from OOo. I can imagine that getting the help files into a wiki require some manual work, so we should chose the web interface that's easiest for us to use. :-) Simplest would probably just a small xstl conversion to html of the application help files. The tooling is now written, just needs testing and polishing: cd clone/help/helpcontent2 ./help-to-wiki.py And you'll see the current result in a wiki/ subdir. Whoever interested in this - patches appreciated! :-) Regards, Kendy I must have missed this conversation on the website or the documentation list, being the two teams who would be the stakeholders and primary drivers of a system like this. Can someone point me to the archive or wiki page regarding the planning and consulting on this? Thanks, Michael Wheatland -- Unsubscribe instructions: E-mail to documentation+h...@libreoffice.org List archive: http://www.libreoffice.org/lists/documentation/ *** All posts to this list are publicly archived for eternity ***
