Re: Trying to re-generate the Documentation effort

2020-07-11 Thread Keith N. McKenna
Greetings Detlaf; See comments in-line On 7/10/2020 7:00 AM, Detlef Nannen wrote: > Hi, > > so far I only have experience with documentation written in AOO itself. > I've been experimenting with Markdown and Pandoc from time to time, and > wasn't always happy with the results and the possibilitie

Re: Trying to re-generate the Documentation effort

2020-07-10 Thread Detlef Nannen
Hi, so far I only have experience with documentation written in AOO itself. I've been experimenting with Markdown and Pandoc from time to time, and wasn't always happy with the results and the possibilities. An amount of time that I was not willing to give. And even now I don't have the time

Re: Trying to re-generate the Documentation effort

2020-07-04 Thread Keith N. McKenna
Hi Carl see comments in-line On 7/4/2020 5:32 PM, Carl Marcum wrote: > Hi Keith, > > On 7/2/20 11:18 AM, Keith N. McKenna wrote: >> On 5/30/2020 8:41 PM, Keith N. McKenna wrote: >>> I should probably have my head examined but I am thinking of one more >>> time trying to revive the documentation e

Re: Trying to re-generate the Documentation effort

2020-07-04 Thread Carl Marcum
Hi Keith, On 7/2/20 11:18 AM, Keith N. McKenna wrote: On 5/30/2020 8:41 PM, Keith N. McKenna wrote: I should probably have my head examined but I am thinking of one more time trying to revive the documentation effort for AOO. One of the drawbacks is that most people that have started to help ha

Re: Trying to re-generate the Documentation effort

2020-07-02 Thread Peter
Am 02.07.20 um 17:18 schrieb Keith N. McKenna: On 5/30/2020 8:41 PM, Keith N. McKenna wrote: I should probably have my head examined but I am thinking of one more time trying to revive the documentation effort for AOO. One of the drawbacks is that most people that have started to help have left

Re: Trying to re-generate the Documentation effort

2020-07-02 Thread Keith N. McKenna
On 5/30/2020 8:41 PM, Keith N. McKenna wrote: > I should probably have my head examined but I am thinking of one more > time trying to revive the documentation effort for AOO. One of the > drawbacks is that most people that have started to help have left as > there has been very limited availabilit

Re: Trying to re-generate the Documentation effort

2020-06-14 Thread Keith N. McKenna
See inline On 6/14/2020 4:41 AM, Peter wrote: > I want to remind you on the talk I posted earlier, which refers to a > toolchain on docbook, and which talks on Issues and chances there are > (the editor has been mentioned as use what you want.) > > I also would like to suggest to check if an exp

Re: Trying to re-generate the Documentation effort

2020-06-14 Thread Matthias Seidel
Hi Peter, all, Am 14.06.20 um 10:41 schrieb Peter: > see inline > > Am 13.06.20 um 22:08 schrieb Keith N. McKenna: >> Francis; replies in-line >> On 6/13/2020 1:46 PM, F Campos Costero wrote: >> >>>   I have two questions at the moment. The second one is really for >>> anyone. >>> 1. I do not see

Re: Trying to re-generate the Documentation effort

2020-06-14 Thread Peter
see inline Am 13.06.20 um 22:08 schrieb Keith N. McKenna: Francis; replies in-line On 6/13/2020 1:46 PM, F Campos Costero wrote: I have two questions at the moment. The second one is really for anyone. 1. I do not see a way to publish to MediaWiki from DocBook. I thought you mentioned there

Re: Trying to re-generate the Documentation effort

2020-06-13 Thread Keith N. McKenna
Francis; replies in-line On 6/13/2020 1:46 PM, F Campos Costero wrote: > Hi Keith, > I have been playing with DocBook and it certainly takes a while to learn. I > suspect that once it was figured out, it would be a workable way to produce > documents in various formats. I say that based on the prog

Re: Trying to re-generate the Documentation effort

2020-06-13 Thread Matthias Seidel
Hi Francis, Am 13.06.20 um 19:46 schrieb F Campos Costero: > Hi Keith, > I have been playing with DocBook and it certainly takes a while to learn. I > suspect that once it was figured out, it would be a workable way to produce > documents in various formats. I say that based on the progress I made

Re: Trying to re-generate the Documentation effort

2020-06-13 Thread F Campos Costero
Hi Keith, I have been playing with DocBook and it certainly takes a while to learn. I suspect that once it was figured out, it would be a workable way to produce documents in various formats. I say that based on the progress I made in about a week starting from zero knowledge. I am, however, still

Re: Trying to re-generate the Documentation effort

2020-06-13 Thread Keith N. McKenna
On 6/13/2020 5:05 AM, Matthias Seidel wrote: > Hi Keith, > > Thank you for your effort! > > I found some typos: > > "Apace" should be "Apache" > > "Anaysis" should be "Analysis" (in file properties) > > Regards, > >    Matthias Thanks Matthias; Thought I had got all those in the source. Ke

Re: Trying to re-generate the Documentation effort

2020-06-13 Thread Matthias Seidel
Hi Keith, Thank you for your effort! I found some typos: "Apace" should be "Apache" "Anaysis" should be "Analysis" (in file properties) Regards,    Matthias Am 13.06.20 um 01:42 schrieb Keith N. McKenna: > On 6/3/2020 9:11 AM, Keith N. McKenna wrote: >> On 5/30/2020 8:41 PM, Keith N. McKenna

Re: Trying to re-generate the Documentation effort

2020-06-12 Thread Keith N. McKenna
On 6/3/2020 9:11 AM, Keith N. McKenna wrote: > On 5/30/2020 8:41 PM, Keith N. McKenna wrote: >> I should probably have my head examined but I am thinking of one more >> time trying to revive the documentation effort for AOO. One of the >> drawbacks is that most people that have started to help have

Re: Trying to re-generate the Documentation effort

2020-06-12 Thread F Campos Costero
Keith, The PDF you sent looks somewhat different than the odt version of the document that I have. Could you send the odt to my personal email? Also, the odt I have uses an external link to get the Apache OpenOffice graphic, i.e. the graphic is not embedded. I can just stick something else in that

Re: Trying to re-generate the Documentation effort

2020-06-11 Thread F Campos Costero
Keith, The only changes I made to the xml to make the second pdf, Proposaltoreinvigerate_fjcc_myStyles2.pdf, were to change from a hierarchical section structure to a nonhierarchical, changing sect1, sect2, sect3 tags to just section, and putting tags around the title, which moved it above the tab

Re: Trying to re-generate the Documentation effort

2020-06-11 Thread Keith N. McKenna
On 6/11/2020 2:48 PM, F Campos Costero wrote: > Keith, > I understand you may be busy with other things. Did you get the documents I > sent? I would be interested to hear your thoughts on how to proceed. > Francis > Francis; Sorry for not replying sooner. I did get them. The second one that you d

Re: Trying to re-generate the Documentation effort

2020-06-11 Thread F Campos Costero
Keith, I understand you may be busy with other things. Did you get the documents I sent? I would be interested to hear your thoughts on how to proceed. Francis On Mon, Jun 8, 2020 at 1:34 PM Keith N. McKenna wrote: > On 6/8/2020 3:17 PM, F Campos Costero wrote: > > Keith, > > I made an HTML and

Re: Trying to re-generate the Documentation effort

2020-06-08 Thread Keith N. McKenna
On 6/8/2020 3:17 PM, F Campos Costero wrote: > Keith, > I made an HTML and a PDF. Should I email them to your personal account? I > believe attachments are stripped out on this list. > Francis > Francis; You can e-mail them to my private account. Thank you very much for your help. Keith > On M

Re: Trying to re-generate the Documentation effort

2020-06-08 Thread F Campos Costero
Keith, I made an HTML and a PDF. Should I email them to your personal account? I believe attachments are stripped out on this list. Francis On Mon, Jun 8, 2020 at 11:55 AM Keith N. McKenna wrote: > Francis; > If you have some time try the XML file from this location > https://1drv.ms/f/s!AsMYmSt

Re: Trying to re-generate the Documentation effort

2020-06-08 Thread Keith N. McKenna
Francis; If you have some time try the XML file from this location https://1drv.ms/f/s!AsMYmStvrJNJinVnnJWlYCHrxzmc just right click on the XML file and chose download on the fly out menu. It is a draft of my analysis document. Thanks for the work you are putting in on this. Regards Keith On 6/8/

Re: Trying to re-generate the Documentation effort

2020-06-08 Thread F Campos Costero
Looking at my first post, I should not have said "[not] even remotely close to high quality material". Let me amend that to "definitely needs work". Francis On Mon, Jun 8, 2020 at 9:03 AM F Campos Costero wrote: > Keith, > I would not say it was a disappointing result at all. I am a complete > n

Re: Trying to re-generate the Documentation effort

2020-06-08 Thread F Campos Costero
Keith, I would not say it was a disappointing result at all. I am a complete novice with DocBook and I have used XSL exactly one time before this. I may have committed any number of rookie mistakes. I was just playing with the tools to see what worked right away and what would need tweaking. I use

Re: Trying to re-generate the Documentation effort

2020-06-08 Thread Keith N. McKenna
On 6/7/2020 11:28 PM, F Campos Costero wrote: > Keith, > I have played with generating DocBook files from odt files and then > producing HTML or PDF from the DocBook. None of the output is even remotely > close to high quality material but I was pleased to get something readable. > Rather than spen

Re: Trying to re-generate the Documentation effort

2020-06-07 Thread F Campos Costero
Keith, I have played with generating DocBook files from odt files and then producing HTML or PDF from the DocBook. None of the output is even remotely close to high quality material but I was pleased to get something readable. Rather than spending more time on what may be a dead end, I will wait fo

Re: Trying to re-generate the Documentation effort

2020-06-03 Thread Peter Kovacs
Am 03.06.20 um 14:50 schrieb Keith N. McKenna: On 6/3/2020 2:32 AM, Peter Kovacs wrote: Hi all, Here is the talk I mentioned earlier. It explains how SuSE is Publishing Documentation (Which is in general), and what Tools they use. https://archive.fosdem.org/2017/schedule/event/writing_open_

Re: Trying to re-generate the Documentation effort

2020-06-03 Thread Keith N. McKenna
On 5/30/2020 8:41 PM, Keith N. McKenna wrote: > I should probably have my head examined but I am thinking of one more > time trying to revive the documentation effort for AOO. One of the > drawbacks is that most people that have started to help have left as > there has been very limited availabilit

Re: Trying to re-generate the Documentation effort

2020-06-03 Thread Keith N. McKenna
On 6/3/2020 2:32 AM, Peter Kovacs wrote: > Hi all, > > > Here is the talk I mentioned earlier. It explains how SuSE is Publishing > Documentation (Which is in general), and what Tools they use. > > https://archive.fosdem.org/2017/schedule/event/writing_open_source_documentation/ > > > Hope it

Re: Trying to re-generate the Documentation effort

2020-06-02 Thread Peter Kovacs
Hi all, Here is the talk I mentioned earlier. It explains how SuSE is Publishing Documentation (Which is in general), and what Tools they use. https://archive.fosdem.org/2017/schedule/event/writing_open_source_documentation/ Hope it is inspiring on creating a new documentation process. I a

Re: Trying to re-generate the Documentation effort

2020-06-02 Thread Rory O'Farrell
On Tue, 2 Jun 2020 14:14:28 -0600 F Campos Costero wrote: > Thanks to everyone for the feedback. I will start to look at how to make > actual documents from the DocBook output of Writer and I will see what I > can figure out about the documentation process. I am certainly experiencing > the feeli

Re: Trying to re-generate the Documentation effort

2020-06-02 Thread F Campos Costero
Thanks to everyone for the feedback. I will start to look at how to make actual documents from the DocBook output of Writer and I will see what I can figure out about the documentation process. I am certainly experiencing the feeling of being lost on a new project. I did subscribe to the doc mail l

Re: Trying to re-generate the Documentation effort

2020-06-02 Thread Keith N. McKenna
On 6/1/2020 10:51 PM, F Campos Costero wrote: > Peter - I regret that my suggestion came across as wanting to "boss people > around". I was responding really to this comment earlier in the thread >> Because all people who expressed interest expected they are told what >> needs to be done where. The

Re: Trying to re-generate the Documentation effort

2020-06-02 Thread Keith N. McKenna
On 6/1/2020 6:23 PM, F Campos Costero wrote: > I am not sure that this part of the process has to remain as it is. >> Unfortunately that is not going to change a whole lot. Just as the >> development effort is self directed so is the Documentation effort and >> all volunteers are advised of that. >

Re: Trying to re-generate the Documentation effort

2020-06-02 Thread Peter Kovacs
Hi Francis, Hi Keith, Am 02.06.20 um 04:51 schrieb F Campos Costero: Peter - I regret that my suggestion came across as wanting to "boss people around". I was responding really to this comment earlier in the thread Imho you have nothing to regret. In a conversation there are at least 2 peopl

Re: Trying to re-generate the Documentation effort

2020-06-02 Thread Pedro Lino
Hi Peter, all > On June 2, 2020 3:51 AM F Campos Costero wrote: > All I meant was that a solution could be to provide such people with > concrete suggestions of what to do first. Of course that can take into > account their interests, skill level and available time. I am sure lists of > possible

Re: Trying to re-generate the Documentation effort

2020-06-01 Thread F Campos Costero
Peter - I regret that my suggestion came across as wanting to "boss people around". I was responding really to this comment earlier in the thread > Because all people who expressed interest expected they are told what > needs to be done where. They did not felt > > comfortable to figure that out on

Re: Trying to re-generate the Documentation effort

2020-06-01 Thread Peter Kovacs
Hi all, Am 02.06.20 um 00:23 schrieb F Campos Costero: I am not sure that this part of the process has to remain as it is. Unfortunately that is not going to change a whole lot. Just as the development effort is self directed so is the Documentation effort and all volunteers are advised of that

Re: Trying to re-generate the Documentation effort

2020-06-01 Thread F Campos Costero
I am not sure that this part of the process has to remain as it is. > Unfortunately that is not going to change a whole lot. Just as the > development effort is self directed so is the Documentation effort and > all volunteers are advised of that. If we can increase participation in the documentat

Re: Trying to re-generate the Documentation effort

2020-06-01 Thread Peter Kovacs
Am 01.06.20 um 17:57 schrieb Keith N. McKenna: On 5/31/2020 10:41 PM, Peter Kovacs wrote: Also socializing seems to be important. The volunteers do not want to work "alone". They want to be part of something. How it is done, did not seem so important to me on first spot. I just want to poin

Re: Trying to re-generate the Documentation effort

2020-06-01 Thread Keith N. McKenna
On 5/31/2020 10:41 PM, Peter Kovacs wrote: > > Am 31.05.20 um 02:41 schrieb Keith N. McKenna: > >> Another would be to use Docbook, though this is not as appealing as I >> have no familiarity with it and it appears that there is a steep >> learning curve to its use and that would be a disadvantag

Re: Trying to re-generate the Documentation effort

2020-06-01 Thread Keith N. McKenna
On 5/30/2020 8:46 PM, Dave Fisher wrote: > Keith, > > I pledge to support you however I can. > > I’ve been thinking about www.openoffice.org > > What do you think about using markdown? > > Regards, > Dave > > Sent from my iPhone I appreciate the pledge of support Dave. I am leery of using mar

Re: Trying to re-generate the Documentation effort

2020-05-31 Thread Peter Kovacs
Am 31.05.20 um 02:41 schrieb Keith N. McKenna: Another would be to use Docbook, though this is not as appealing as I have no familiarity with it and it appears that there is a steep learning curve to its use and that would be a disadvantage to attracting new people. The SUSE documenters use(

Re: Trying to re-generate the Documentation effort

2020-05-31 Thread Keith N. McKenna
On 5/31/2020 7:38 AM, Carl Marcum wrote: > Hi Keith, > > On 5/30/20 8:41 PM, Keith N. McKenna wrote: >> I should probably have my head examined but I am thinking of one more >> time trying to revive the documentation effort for AOO. One of the >> drawbacks is that most people that have started to

Re: Trying to re-generate the Documentation effort

2020-05-31 Thread Matthias Seidel
Hi Carl, Am 31.05.20 um 13:38 schrieb Carl Marcum: > Hi Keith, > > On 5/30/20 8:41 PM, Keith N. McKenna wrote: >> I should probably have my head examined but I am thinking of one more >> time trying to revive the documentation effort for AOO. One of the >> drawbacks is that most people that have s

Re: Trying to re-generate the Documentation effort

2020-05-31 Thread Carl Marcum
Hi Keith, On 5/30/20 8:41 PM, Keith N. McKenna wrote: I should probably have my head examined but I am thinking of one more time trying to revive the documentation effort for AOO. One of the drawbacks is that most people that have started to help have left as there has been very limited availabi

Re: Trying to re-generate the Documentation effort

2020-05-31 Thread Marcus
Am 31.05.20 um 02:46 schrieb Dave Fisher: I’ve been thinking about www.openoffice.org What do you think about using markdown? we are using on some webpages quite intensive Javascript. Is markdown able to handle this? In general, I don't see the need to use markdown more widely in the websi

Re: Trying to re-generate the Documentation effort

2020-05-30 Thread Dave Fisher
Keith, I pledge to support you however I can. I’ve been thinking about www.openoffice.org What do you think about using markdown? Regards, Dave Sent from my iPhone > On May 30, 2020, at 5:42 PM, Keith N. McKenna > wrote: > > I should probably have my head examined but I am thinking of one