Re: Adding module descriptions

[Behdad Esfahbod <behdad behdad org>]

On 04/16/2009 04:58 PM, Owen Taylor wrote:
> The great migration to git.gnome.org is now underway.

Neato.

> Once your module
> shows up on http://git.gnome.org/cgit/, you'll notice that it is
> described as:
>
>   Unnamed repository; edit this file to name it for gitweb.
>
> Since you want something better than that, what you are going to do to
> fix is add a file in the toplevel of your module named:
>
>   <modulename>.doap

Are we moving away from the MAINTAINERS file?

/me doesn't like duplicate information

behdad

> Which is a DOAP file (in RDF/XML) for your module. As an example, for
> the pango module, the file would be called 'pango.doap'. A DOAP file is
> a "description of a project" file, and allows listing all sorts of
> things about your module in machine-readable form. We'll likely use more
> from it in the future, but for now the only thing that matters is the
> 'shortdesc', which should be a phrase like:
>
>   Internationalized text layout and rendering library
>
> (No leading 'A' or 'The', no trailing period)
>
> Thanks to Shaun McCance there's no need to worry about how to create a
> DOAP file, just find your module in:
>
>   http://www.gnome.org/~shaunm/pulse/web/
>
> And select the "Download DOAP template file" link to get a DOAP file for
> your module that you can then edit as necessary. It might even already
> have a good shortdesc if Pulse could find one from your .desktop file.
>
> - Owen