[TYPO3-doc] purpose of wiki/ wiki-documentation-FAQ

[Daniel Brüßler]

Hi Jakub,

I started a FAQ for you and for others who want to understand and
contribute. You help much with your ideas and questions, because so the
wiki-usage gets better and more understandable.

http://wiki.typo3.org/index.php/FAQ_about_wiki-documentation

Please be patient with me that I focus on the main-questions what are
important NOW and not on some single questions what are important for
the FUTURE.

See the template what we use for CURRENT
http://wiki.typo3.org/index.php/Ext_template
and see the help-page about it

http://wiki.typo3.org/index.php/Help:Contents#Template_-_for_new_Extension-page
Do this part of the help-page need an explaining sentence?

kind regards
Daniel Brüßler



Jakub Tesinsky schrieb:
> I have commented my edits on the Talk page and the reason I have edited
> the page is that i think that it should look this (or similar way). I am
> not saying this because I am particularly proud of this edit, but
> because it very nicely shows vision of wiki. Please open two browser
> windows and browse to page
> http://wiki.typo3.org/index.php/Sr_feuser_register and
> http://wiki.typo3.org/index.php/User:Gorn/sr_feuser_register (I put an
> example here).
> 
> The two pages bear the SAME AMOUNT of information - one sentence + one
> link + one category. Yet I consider my version far more clean and
> comprehensive. Questions about yours page:
> 
> * Why there are three empty chapters  Dependency,  See also, Discussion?
> Is there somebody going to fill them up?  I think no.
> * If somebody wants to start a Disussion or place a See also topic he
> can add the heading anytime.
> * The "Dependancy" subsection is worst - it contains some predefined
> sentence which has NO meaning to everyone going to use this page except
> ONE person: an owner. And still it is only empty list.
> * The beginning of ANY article should start with sentence or two
> explaing briefly what is the page about. It should start with
> information. All links to elsewhere (especially non-wiki links) should
> be put at the bottom, because they are the last thing the user is going
> to do - decide where to go next. If this is not done, then the wiki is
> only a collection of links, which is insufficient.
> * Yes I can imagine that there was some decision about the basic
> extension article template and you are only expanding it on this page. I
> do not object to you doing so, I object to the decision.
>