On Thursday 18 October 2007 00:22:45 Josef Assad wrote:
Peter Flodin wrote:
On 10/18/07, Josef Assad
wrote: The first point up there goes to the heart of what Martin is working on: the separation. The second point up there goes to the issue of, how do we make contributions more accessible. I think the real challenge is, how can we have structured and consistent documentation like SDB and not scare potential contributors off with an elaborate style and formatting guide.
Well the answer is simple, and it is the same principle that Wikipedia uses. Someone else will fix your formatting :-)
I was hoping the Wiki Team would claim this one (didn't want to volunteer anyone) and the Wiki Team doesn't disappoint. :) I agree entirely.
regarding your flowchart: i think this is a good idea, but i'm not sure if the FAQ branch is ok. A FAQ is for me: Q: Virtualbox is not starting and complains about a module A: you have to load vboxdrv, bla bla Q: I loaded the modul but it's still complaining A: you have to set the right permisions, bla bla These are 2 examples of _common_ problems a newbie with Virtualbox will have when he don't bother to read the documentation (what usually nobody does :-)). My rephrasing would be: Look if there is an existing FAQ and add the solution if needed. If there is no existing FAQ, think about starting a new FAQ about the component/program. maybe i just don't understand your sentence right away ... -- with kind regards, Martin Lasarsch, Core Services SUSE LINUX Products GmbH, Maxfeldstr. 5 90409 Nürnberg GF: Markus Rex, HRB 16746 (AG Nürnberg) martin.lasarsch@suse.de - http://www.opensuse.org --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-project+help@opensuse.org