Re: [Tracker] Documentation
- From: Martyn Russell <martyn imendio com>
- To: jamie mccrack gmail com
- Cc: Tracker-List <tracker-list gnome org>
- Subject: Re: [Tracker] Documentation
- Date: Mon, 29 Sep 2008 16:40:09 +0100
Jamie McCracken wrote:
agree - maybe gtkdoc?
I would rather not, I hate GtkDoc :) and it is far from compliant with
Windows, Tor had to add hacks around GtkDoc to get Evolution and other
technologies working on Windows with it. I have had to do this too.
To me it makes sense to just use a simple text format. This is really
short documentation pieces describing how to integrate with Tracker for
developers. It doesn't need to be too fancy or exported to any formats
like PDF. HTML browsers can usually read clear text too so we don't need
to use Docbook I would say.
that way we could point to it in svn as html like gtk documentation
Well, it isn't that simple. The GTK+ documentation is actually generated
from what is stored in the GTK+ source tree and then hosted somewhere.
So we would have to manually do that extra step. Unless someone on l.g.o
would do that for us with the other projects that have documentation?
We really just need somewhere to list all the documentation links
collectively I think. We could use live.gnome.org for that.
--
Regards,
Martyn
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]