On 17/08/2013, at 9:49, Mark LaPierre <marklap...@aol.com> wrote: > On 08/16/2013 02:35 AM, Robert Großkopf wrote: >> Hello Mark, >> >> I 'm the person, who had written most of the German Base-Handbuch. >> >>> >>> I've written documentation for programs that I've written. I've been >>> writing test scripts quite a lot recently. Are there test scripts for >>> LO Base? Maybe that might be a good use of my time. >> >> What Do you mean with "test scripts"? Could it be you are looking for >> example-databases? There are some databases already translated to >> english, but some other examples aren't. The examples of the >> Base-Handbuch 4.1 you will find here together with the chapters of the >> whole Base-Handbuch. >> >>> >>> I'm no C programmer so I don't think I've got a lot to offer with >>> coding. I'm assuming that LO Base is primarily written in C. >>> >>> I have a son who speaks German so maybe I can ask him to help me >>> translate the German Base documentation into English. >> >> Don't know where the English chapters of the old Handbook could be >> downloaded. ODF-Autors, I think. The english version is made with of the >> German Base-Handbuch 3.5. Only the chapter for the reports is from >> version 4.0. I have seen, there is a version 4.0 - but it seems to be >> the same. >> >> I have created a Calc-document, which shows the difference between the >> versions (only the chapters, which had been added) and, marked by >> comments, the chapter, where you could find the new functions of Base in >> version 4.1. This new functions are a "must be" for a book for version 4.1. >> >> This document, together with the whole LO 4.1-Handuch, you can find here: >> http://robert.familiegrosskopf.de/lo_hb/ >> The docoment, which show the difference, is >> http://robert.familiegrosskopf.de/lo_hb/Vergleich_Base_Handbuecher.ods >> >> All these documents are written in German. But when I would try to >> translate it could be I don't find the right words for the content. My >> favorite website with a whole traffic when reporting bugs is >> http://www.dict.cc/ >> So could be better that someone will translate, who speaks English very >> well. >> >> Regards >> >> Robert >> >> > > Hey Robert, > > When we develop a new piece of software we also write a test script that > fully describes all the steps that a user should take and the results > expected. For example: > > Step 1: > Action: Click the [File] button. > Result: File dialog box opens. List of files appears in the scroll box. > Pass: Fail: Comment: > > Step 2: > Action: Click the [Up Level] button. > Result: File scroll box moves up one level in the file system. > Pass: Fail: Comment: > > This provides a fully documented functional description of the software and > verification that the software functions as advertised. Nothing goes to > production until it has a clean test script. > > Writing test scripts, and later documentation, is onerous work that most > developers prefer to avoid. Writing code is way more fun. > > The result is that we end up with lots of undocumented software. It has > functions that are accessible with the right combination of inputs, just like > a video game, but you have to poke around and experiment to discover what it > does. Undocumented software is just a video game.
The Docs Team does user docs, not developer docs or testing/QA docs like test scripts, though of course the program needs all types. You might like to contact the developers and/or the QA team to see what they have and/or what else they might want to have. I know they can always use more help (just as all of the teams can use more help). Later today I will get on my computer and give you more info about the user docs for Base. --Jean -- To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.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.libreoffice.org/global/documentation/ All messages sent to this list will be publicly archived and cannot be deleted