[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-devel
Subject:    Re: new KDE Development book
From:       Brad Hards <bhards () bigpond ! net ! au>
Date:       2003-07-21 8:17:39
[Download RAW message or body]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Mon, 21 Jul 2003 16:14 pm, Ralf Nolden wrote:
> Now, enough talk. Should we get going with a separate CVS module or should
> we start in kdenonbeta first ?  (where I don't have a good feeling that too
> many people would put their stuff there :) so a kde-books (because the
> contents will span more than one book I guess :-) module is probably the
> best way to go. Any volunteers for generating the automake framework and
> putting it in CVS ? BTW this would also have the advantage that we could
> make exercise programs *inside* this module and one can compile the book
> together with the exercises :))
Before we code our book, perhaps a bit of design and coding standards work.

Assuming DocBook, I imagine that we are talking about
Book
Part
Chapter
Section1
Section2

What stuff belongs at what level? For example, there was discussion of a C++ 
intro - where does that go? What about the PyKDE description? How do we fit 
in stuff like: 
http://developer.kde.org/documentation/tutorials/dot/panel-applets.html or
http://developer.kde.org/documentation/tutorials/dot/dcopiface/dcop-interface.html
(assuming that the authors agree to licensing and re-use).

Which DocBook? XML or SGML?

How do authors get recognised? What about editors, reviewers and contributors?

Do we include compilable examples (as opposed to fragments) as inline, or do 
we use hacks like:
<example><title>Basic example</title>
<programlisting>
<inlinegraphic fileref="examples/example.c" format="linespecific">
</programlisting>
</example>

What license do the examples fall under? Can readers use bits of them in 
proprietary or BSD licensed code?

[Yep, I'm excited by the concept too!]

Brad
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.7 (GNU/Linux)

iD8DBQE/G6GjW6pHgIdAuOMRAvdcAKCFzg6A3JkfbLXI0dj+N1TmUDTqjgCfbdSV
3rxfGEYzqrNTQUig830GYmw=
=tJG3
-----END PGP SIGNATURE-----
 
>> Visit http://mail.kde.org/mailman/listinfo/kde-devel#unsub to unsubscribe <<

[prev in list] [next in list] [prev in thread] [next in thread]