Re: gbrainy Mallard documentation

[Milo Casagrande <miloc gnome org>]

Hi Jordi,

sorry for very slow reply.

2009/12/27 Jordi Mas <jordimash gmail com>:
> I have been working on the last days in adding the documentation using
> Mallard to gbrainy[1].

That's great!

> I would appreciate some input / help in these area:
>
> 1) Since I added Mallard support I get the following error when running
> autogen.sh:
>
> Running automake --gnu  ...
> gnome-doc-utils.make:74: if $(DOC_H_FILE: non-POSIX variable name
> gnome-doc-utils.make:74: (probably a GNU make extension)
> help/Makefile.am:1:   `gnome-doc-utils.make' included from here
> gnome-doc-utils.make:77: if $(DOC_H_FILE: non-POSIX variable name
> gnome-doc-utils.make:77: (probably a GNU make extension)
> help/Makefile.am:1:   `gnome-doc-utils.make' included from here
>
> Any idea on this?

Are you still having this problem? Is this a blocker thing or it
compiles anyway?

> 2) Any comment on the use of Mallard in gbrainy [2]? Specially anything that
> is not following the expected standards.
>
> 3) Any comment or suggestion on the documentation structure for gbrainy and
> its contents?

I've been playing a little bit with gbrainy help to move it into a
more topic-base approach, splitting up some of your paragraphs into
smaller chunk of information and giving the document almost the same
structure as the GNOME Tetravex one I've been playing around.

You can find the initial work here:
http://gitorious.org/gbrainy-help

The topics there are not all written, I added them in order to see the
structure of the "entire" help, some others are missing, and the
entire help needs a good review.

What do you think of a structure like that? If it's OK I can go on and
work on that a little bit more, and maybe complete the help (but
unlikely for the mid-January release).

Let me know.

Ciao.

-- 
Milo Casagrande <miloc gnome org>