[Pkg-ruby-extras-maintainers] Website review

[Lucas Nussbaum]

On 03/08/06 at 22:12 +0200, Paul van Tilburg wrote:
> Hello everyone,
> 
> This mail contains a review of the website.  I've performed it per page,
> taking into account comments that I have received.  Note that in this
> mail nor the previous I want to sound grim or negative.  I just want to
> offer an sort of object list of things that need to be improved.
> 
> /home/paul/Debian/pkg-ruby-extras/website/src
> |-- 00.index.en.page
>      -> Needs a remark about Patrick joining the team.

I've slightly reworked the beginning of the page

> |-- 00.index.es.page
>      -> Needs updating.

Do we really want to maintain translations of the website ? I don't
think it's that important for such a technical website.

> |-- 10.join.en.page
>      -> Maybe needs more about how/why/when we are accepting people,
>         i.e. our acceptance policy.  This has ben discussed before.

I've added a note about the delay before getting access on
svn.debian.org. It would really be great if newcomers to the team could
add more info to this page.

> |-- 20.create.en.page
>      -> This page is not clear and also is not finished.  It needs more
>         about how to prepare the source, when a diff.gz is nice enough.
>      -> Strange order...  you don't have to CDBSify it first to be able
>         to inject it.
>      -> Mention that watch-files have to be added and why...

I've took the initiative to rename svn-build.en to subversion.en, merge
into it the "importing a package" part of create.en, and remove
create.en (the CDBS part is already in ruby-pkg-tools/cdbs.en)

> |-- 30.svn-build.en.page
>      -> As mentioned before on the list.  Maybe give a list of useful
>         aliases or build commands.  Not to force it on everybody but it
>         might contain useful stuff.

still to do

> |-- 35.policy.en.page
>      -> A lot has to happen here.

yup. But I have added a link in the menu. The top of the page is clear
enough to avoid confusion.

> |-- 40.rubygems.en.page
>      -> Do we need to change our position?

I don't think so. Why so ? It just needs to be updated as soon as
the rubygems package hits unstable.

> |-- 50.upstream-devs.en.page
>      -> This page is not linked, should we? Is it finished?

The "Use setup.rb" section still needs to be written. If somebody want
to work it, feel free. I've also added the page to the menu.

> `-- ruby-pkg-tools
>     |-- 00.index.en.page
>           -> Remove stuff about the damned sources file! :)

I've moved it to the bottom of the page, and added a note about it only
being used for packages not supporting watch files.

>           -> Link per item to the page explainig each item.

done. I also moved sources.en from 10 to 50 to reflect the new order.

>     |-- 10.sources.en.page
>           -> Registering source should be about watch-files, not the
>              dead sources file.

done

>           -> If we have a plan for upstream with problematic
>              watch-files, also include it.

I mentionned the fact that the sources file should only be used for
packages where watch files are not a solution.

I also added a note about the missing comma problem to
20.team-members.en.page.

>     |-- 30.cdbs.en.page
>          -> Mention that debhelper & cdbs should be build-depends and
>             the rest possibly build-depends-indep.

done

Lucas
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-ruby-extras-maintainers/attachments/20060808/a666bdef/attachment-0001.pgp