Re: Ok to redirect http://developer.gnome.org/doc/API/2.0/ to GNOME Library?

[Murray Cumming <murrayc murrayc com>]

On Mon, 2007-08-27 at 10:42 +0200, Frederic Peters wrote:
> Murray Cumming wrote:
> 
> > > | libxml + libxslt point to elsewhere, not sure if
> > > have since been added as links
> 
> I also saw yesterday they were available in devhelp, so it should
> probably be possible to format them for library.
> 
> 
> > > | gstreamer as well
> > > also a link
> > 
> > Yes, for instance, library.gnome.org currently links to freedesktop.org.
> >
> > I wonder why we don't just host the documentation for this in
> > library.gnome.org.
> 
> All the fdo specs are now copied and formatted for library, but this
> feature is currently limited to standalone documents.
> 
> See http://bugzilla.gnome.org/show_bug.cgi?id=468525

That's good, but it doesn't seem relevant to having gstreamer
documentation in library.gnome.org

> > > | do we have libgda?
> > > no idea
> > 
> > Yeah, it would be nice to have this.
> 
> It was all under the "gnome-db" title on developer.gnome.org, and I
> did it the same way on library (fixing the link to point to a more
> correct location).

It would be nice to have the docbook API reference in library.gnome.org
itself. And I think it would actually be more sensible to list libgda
and libgnomedb separately. And they are not official "GNOME Desktop"
libraries, so they should probalby be in the "Other" or a "gnome-db"
section.

> > > | and of course gtkmm
> > > on libgo
> > 
> > Until gtkmm can be fully supported on library.gnome.org (there's some
> > work to do there still, mostly by me), I guess that should just link to
> > gtkmm.org's documentation page for now.
> 
> I think the only missing thing is a glibmm release with <div
> id="content">;

I thought we did that.

>  but I can change this to point to gtkmm.org for the
> moment.

I'm mostly concerned that the link goes to this index.html page, which
is usually hidden away and not linked easily:
http://library.gnome.org/devel/gtkmm/2.11/

This is a more useful starting point, though it's for all the *mm APIs:
http://www.gtkmm.org/documentation.shtml

We also need to make sure that links work from, for instance, the gtkmm
documentation into glibmm. For instance, when clicking on Glib::ustring
here:
http://library.gnome.org/devel/gtkmm/2.11/classGtk_1_1Button.html#e377dbb125d9beb6e6fdd5b191f785aa

And we need to make that work for all the other *mm APIs and get them on
library.gnome.org too.

Until we figure that out, it would be best just to link to 
http://www.gtkmm.org/documentation.shtml

-- 
murrayc murrayc com
www.murrayc.com
www.openismus.com