[ocaml-infra] Wireframe demo of OCaml.og

[Maxence Guesdon]

On Fri, 15 Mar 2013 14:06:12 +0100
Sylvain Le Gall <sylvain+ocaml at le-gall.net> wrote:

> ...
> >> I think merging providing Hump info through OASIS-DB is a 0day work.
> >
> > Apart from putting information in form, which is the longest part of
> > course.
> 
> The only real field to fill in the URL where you can download the
> .tar.gz and its optional (in this case we use a local copy). The order
> parameter should be correct if you don't have a crazy versionning
> scheme.
> 
> The package name and version are guessed based on configure.ac/META
> file or _oasis . The name/version are only editable when we have to
> guess (i.e. no _oasis in the tarball).
> 
> I would say uploading a tarball and filling 1 field in a form is not a
> big deal. The command line interface allows you to directly upload the
> tarball with the URL (good for automatisation).

The aim of the Caml Hump was just to list existing software (and
eventually documentation resources, but these can be listed somewhere
else, on the ocaml.org site for example). Some of these existing
software don't even have a tar.gz, nor a version number, and even less
a META or _oasis file. But still I think it's important that they
appear somewhere as potential packages, work in progress, and
generally as existing code base.

So the system where they should be listed should put as less
constraints as possible. 

> >> The RSS:
> >> http://oasis.ocamlcore.org/dev/feeds/rss2
> >
> > Well, this is a oasis-db feed, not a per-package feed as such one
> > appeared in Amir's demos, on the Core package page.
> 
> Sorry, read too fast. I will probably add a couple of fields like
> ProjectRSSFeed, ProjectGooglePlus, ProjectGithub and ProjectTwitter to
> _oasis.
> 
> Also, I am wondering if it is not damaging to have a feed with very
> little news for pakcages (Core has content in its feed, but this is
> not a general case). E.g. there is a lot of small projects/libraries.

I think software libs or tools authors provide RSS feed when there is a
minimum posts/announces/... activity. RSS feed is not mandatory, but
when it exists it would be useful to see it on a package page.
 
> >
> >> The API:
> >> http://oasis.ocamlcore.org/dev/api/
> >>
> >> Looking at the wireframe, I think we should also consider displaying
> >> GODI and OASIS-DB information. This can be very useful to dev that can
> >> quickly see that there are 1 version behind of a package (e.g.
> >> ocaml-expect is lagging one version behind in OPAM wrt to OASIS-DB).
> >
> > I think there should be one and only one place to put information about
> > packages feeding the ocaml.org website.
> >
> 
> I beg you to reconsider this. I know it is easier and nicer to have
> only one package manager and one place to look for, but I don't think
> skipping other sources is good. You should at least consider the
> option to do so. I really don't want to see GODI and OASIS-DB removed
> from the big picture.

In this case, a merging must be done from various sources. This can be
done using the homepage of the lib or tool for example; reading all
information from various sources for a lib or tool, and merging, hoping
there are no conflict.

- m