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.
--
_
°v°
/(_)\
^ ^ Mark LaPierre
Registered Linux user No #267004
https://linuxcounter.net/
****
--
To unsubscribe e-mail to: [email protected]
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