Re: Setting up a wiki for GNU Project volunteers?

[Federico Leva (Nemo)]

Carlos O'Donell, 10/12/19 20:25:

Selection criteria for a wiki?


It must support multilingualism and have the best-in-class support for 
i18n, which is currently a GNU high priority.



Federico

Setting up a wiki for GNU Project volunteers?

[Carlos O'Donell]

Wikis are useful software that allows developers to work
collaboratively and quickly on informal documents that are part of the
day-to-day running of the packages or project activities.

This includes documenting such things as:
- Email thread summaries
- Status updates
- Meeting notes
- Summaries of discussions around best practice activities

In researching this kind of wiki setup I have discussed the issue with
various GNU Maintainers and the consensus seems to be that such a
system should have the following qualities:
- Based on a VCS e.g. git
- Uses a supported wiki platform e.g. dokuwiki
- With a sensible markup e.g. markdown plugin for dokuwiki

What do people think about setting up a wiki?

Several packages already have wikis like:
The GNOME Project (https://wiki.gnome.org/)
The GNU C Library wiki (https://sourceware.org/glibc/wiki/)
The GNU Debugger wiki (https://sourceware.org/gdb/wiki/)
The GNU Compiler Collection wiki (https://gcc.gnu.org/wiki)

However, we have no good central community wiki to put document those
things listed above.

Does anyone have a strong opinion on which wiki software should be used?

Selection criteria for a wiki? I'm suggesting dokuwiki + git.

Access controls for the wiki? Anyone who volunteers or wants to
volunteer their time to the GNU Project?

Where could we host a wiki like this without causing confusion with
official project content?

Lastly, for direct discussion of the GNU Coding Standards and
Information for GNU Maintainers please see
https://lists.gnu.org/mailman/listinfo/bug-standards. Wiki summaries
could feed into discussions on bug-standards or bug-standards
discussion could get summarized into the wiki to build consensus for
particular changes.

Looking forward to any feedback volunteers want to provide.

Cheers,
Carlos.

Re: A GNU “social contract”?

[Carlos O'Donell]

On Tue, Dec 10, 2019 at 8:21 AM Carlos O'Donell  wrote:
>
> On Sat, Nov 9, 2019 at 12:44 PM Andreas Enge  wrote:
> >
> > On Thu, Nov 07, 2019 at 09:46:56PM +0100, Ludovic Courtès wrote:
> > > Thanks, Andreas, for this new version!  Some comments below.
> >
> > They are integrated into the attached new version. For good measure,
> > I have capitalised "GNU System" as you did and thrown in a few italics
> > as suggested.
>
> This looks great! +1 from me.
>
> I like that we have 4 straight forward items.
>
> Cognitively I might like 5 items. Humans tend to like 3, 5, or 7 items.
>
> You can count 5 on your hand.
>
> Some cultures really like 5 item lists. Some cultures dislike the
> number 4 and find it bad luck.

5. Reserved for future use!

Just put it into the contract and leave it for future use ;-)

Cheers,
Carlos.

Re: A GNU “social contract”?

[Carlos O'Donell]

On Sat, Nov 9, 2019 at 12:44 PM Andreas Enge  wrote:
>
> On Thu, Nov 07, 2019 at 09:46:56PM +0100, Ludovic Courtès wrote:
> > Thanks, Andreas, for this new version!  Some comments below.
>
> They are integrated into the attached new version. For good measure,
> I have capitalised "GNU System" as you did and thrown in a few italics
> as suggested.

This looks great! +1 from me.

I like that we have 4 straight forward items.

Cognitively I might like 5 items. Humans tend to like 3, 5, or 7 items.

You can count 5 on your hand.

Some cultures really like 5 item lists. Some cultures dislike the
number 4 and find it bad luck.

Cheers,
Carlos.