Re: [Mingw-msys] Wiki

[Earnie B. <ea...@us...>]

Julien,

I started answering below; but now I'm going to ask that you rework this
post and post it to mingw-users instead of this list.  Please move the
change Why to FAQ to the first item of business.

Earnie

On 10:52:23 am 2005-08-12 "Julien Lecomte" <lec...@fr...> wrote:
>
> Hello all,
>
> I've talked a while ago about "reformatting" the wiki. Here are my
> thoughts on this :
>

I've contemplated an answer way too long.  I still don't have a good one.

> HomePage :
> - MinGWiki Page: keep
> - Getting Started: keep
> - The IdeaBoard is barely used. We should remove it.

- Mark the page as defunct but keep it.

> - MinGWCautions: move to FAQ
> - DebuggingTips: move to FAQ
> - SourceExamples: move down to under FAQ

- Moving from the Wiki is a NoNo.

> - WhatIsIt: change title/subtitle to "Packages Guide : an explanation
> of all individual packages". ...

Leave WhatIsIt and perhaps add PackageGuide.  Note, WikiWiki words are good
in a Wiki.  WhatIsIt is more than a PackageGuild

> ... Inside it; remove dead links and ...

If you mean the references that have yet to be edited; then let us add
information.  They don't need removed.

> add all
> packages which already have a description (ie :
> http://www.mingw.org/MinGWiki/index.php/binutils)

Ok, you can add a pointer to the binutils page.

> - WhereIsIt: redundant with above, so remove. ...

WhereIsIt is _not_ the same as WhatIsIt.  Items may need to be reworded but
what and where have different meanings.

> Inside, "MinGW
> resources" and "the next resource" should be moved to FAQ.

Moving information from the Wiki is a NoNo.

> - HowDoI: Move some articles to the FAQ (use threads with MINGW,
> build VB dll with MINGW, etc...) And only keep full length tutorials
> on x-compiling, installation, compiling, ...

Double NoNo!

> - Why: rename to FAQ; reformat page inside as Question/link to answer.

You should have had this as your first item!  Then, maybe I would not have
said NoNo.  So you're really thinking that we need fewer items on the main
wiki page.


> - Unanswered Questions: move to FAQ, remove stub links so links
> appeared as unanswered.
> - Forums: new link to http://sourceforge.net/forum/?group_id=2435
>
> Other possible changes :
> - Remove all WikiWikiWords when possible to prefer links with nice
> titles. On the wiki home; that would mean "GettingStarted" would be
> changed to "[Getting started|GettingStarted]
> - Try to format everything the same. Packages as
> http://www.mingw.org/MinGWiki/index.php/bash; building packages as
> http://www.mingw.org/MinGWiki/index.php/Build%20bash
>
> That would leave the home page with a minimum of direct links to
> pages that are better formated and more direct.
>
> Comments welcome,
> Julien