Mailinglist Archive: opensuse-project (169 mails)

< Previous Next >
Re: [opensuse-project] SDB/Howto/FAQ
  • From: Josef Assad <joe@xxxxxxxxxxxx>
  • Date: Wed, 17 Oct 2007 18:41:05 +0200
  • Message-id: <47163B21.4070501@xxxxxxxxxxxx>
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Martin Lasarsch wrote:
> Hi
> - is this point of view valid for most of you?
> - do we need the separation?

I looked at the separation from the perspective of someone who has
something to write up on the wiki and is trying to figure out where it
goes. Following your separation definition, I would suggest this as a
more concise way to tell if it is SDB or HOWTO:

- - If it is reactive (i.e. there was a problem de facto, this is how I
solved it) then that's an SDB
- - If it is proactive (my box is fine, but I'd like to figure out how to
do this or that) then this would be HOWTO

Of course the problem with that is we might end up with a lot of HOWTOs
or varying intensity (en.opensuse.org/HOWTO_chage_user_picture_in_KDE ;
eek!), but that's a different issue. Could call 'em mini-howtos or just
let them accumulate and then corral them off into a section which can be
inaugurated down the line called "Tips and Tricks" or whatever we please
then.

This method of separating has the advantage that it is less confusing,
which would hopefully translate to more entry-level user contributions
(gotta start somewhere!).

> - what is missing?
> 
> * SDB

<snip>
What I like about SDB is that there is a set format. No telling what
kind of funny things we could do with a broad selection of articles all
coherently formatted.

Of course, new contributors might just want to rush to dump a snippet of
wisdom on the wiki; having to follow a very specific set of formatting
rules might be off-putting. I'm not immediately sure how to address
that; maybe encouraging documentation free-for-alls in user pages and
then polishing these into SDBs? Worth thinking about; I genuinely think
there's value in standardized documentation.

> * Howto

<snip>

> * FAQ

<snip>

I'll add one more thing just to stir up the pot; screencasts. Should
that be a fourth category?



JA

- --
http://www.DonAssad.com
jabber ID: josef.assad@xxxxxxxxx

Please consider the environment; do you really need to print out this
e-mail?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.4-svn0 (GNU/Linux)
Comment: Using GnuPG with SUSE - http://enigmail.mozdev.org

iD8DBQFHFjshFcf72sjD2+QRAt9YAJ9e3r/8dCV68jhJ52oSRIqWxCq9DwCcDXAD
qZ0vguUq2us/R0j3CwkWxDc=
=JlW+
-----END PGP SIGNATURE-----
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-project+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-project+help@xxxxxxxxxxxx

< Previous Next >
Follow Ups
References