Hi Cecilia,
The HSQL or HSQLDB is the same, abbreviation of HyperSQL DataBase,
http://hsqldb.org/.
Base grow out of database connection part of OOo, it is asked on time
when OOo 1.0 was developed.
In OOo 2.0 introduced new application, and new file format for database
file which included HSQLDB files.
When you opens odb file with embedded HSQLDB content, the OOo first
unpack files from odb container (from /database folder), into memory,
secondly start HSQLDB server in memory, load database tables and data
into server, you manipulate data, when you finished first OOo stops
HSQLDB, pack files back into odb container.
When you use odb file as front-end to external database server is
another issue.
We assume that the user of Base Guide has not so much database
knowledge, it is my experience on user forums.
Users first use OOo Writer or Calc, and after some time they try Base,
they max 10 % of OOo users.
Another type of Base users is application developers, who develops
applications with OOo.
We, as I understand create Guide for first type of users, and they needs
more explanation.
When they pick Base Guide, may not read GS Guide Base Chapter, before .
I hope this clarified a liitle the situation around Base Guide.
Zoltan
2010.09.12. 0:15 keltezéssel, Cecilia Cheung írta:
Hello Zoltan,
Having just quickly scanned through some of the text you suggested, it seems
that there are inconsistency in referring the database engine, some text
referred it as HSQL, while other referred it as HSQLDB. In the world of
databases, MySQL, Microsoft Access, Oracle etc are database management systems
(DBMS), very rarely refer to as database programs.If we are writing a user
guide for Base, the guide should have self contained information clearly
telling the users what they need to know about Base and how to do X,Y,Z. If we
assume our target audience has knowledge of database, then why are we trying to
explain what a database is in the introduction of chapter 1. Wouldn't it be
more beneficial to have a diagram or two showing where Base sits among the
different components of the OOo software suite, what Base is made up of, the
environment it runs on, and which component of the OOo suite interacts with
Base?I find the explanation on table, view, database, data source very
confusing and as a result, additional notes were added in an attempt to clarify
the differences. It is always helpful to have a glossary of terms for reference.
Cecilia
Date: Sat, 11 Sep 2010 21:20:38 +0200
From: [email protected]
To: [email protected]
Subject: Re: [authors] review helper
Hello Cecilia,
2010.09.11. 19:27 keltezéssel, Cecilia Cheung írta:
Hello Zoltan,
Thank you for your info. I have just started reading chapter 1 - Introducing
Base.As I am new to this document, I found the following:
1) unclear terminology used - for example: database program2) unclear
statement - for example:
With
the right program called a driver, Base can access databases like
these as well as others.3) terms used that have not been introduced or
explained, an example is:Base
uses the HSQLDB 1.8
database engine to create and later update ODF 1.2 database frontend
documents.
I suppose. may be I wrong, that the readers pick this user guide, after
they went through "Getting Started with OpenOffice.org 3"
http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started
and they knows database basic terms from GS Base chapter:
http://wiki.services.openoffice.org/wiki/Documentation/OOo3_User_Guides/Getting_Started/Getting_Started_with_Base
Listed above are just a few but not limited areas that I picked up as I was
reading.If we assume our target audience has no knowledge of database, then we
have to communicate in clear, plain and well structured text. In this occasion,
the document seemed to have fallen short of that goal.
The chapter what you reviewed is a first chapter to the user guide,
which contain more chapters, when we finished will be a book.
May be needs to add an annex after last chapter, explanation of all
database specific terms.
Zoltan
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
