Differences between revisions 4 and 5
Revision 4 as of 2009-02-08 14:50:26
Size: 2055
Editor: FranklinPiat
Comment: Wiki isn't the most appropriate place for software documentation.
Revision 5 as of 2009-02-08 21:52:28
Size: 4371
Editor: FranklinPiat
Comment: answer previous post
Deletions are marked like this. Additions are marked like this.
Line 56: Line 56:
Hallo FranklinPiat,

@"I want a better documentation of Debian and Debian software in this wiki".

I'm especially talking about this wiki here. If you compare the German section of this wiki here to

wiki.ubuntuusers.de

then what you can find here is pretty poor. I think Debian should have a similiar wiki, too, although most Debian users are more experienced than Ubuntu users and don't need that much help. There is already good help on the net like

http://www.debiananwenderhandbuch.de

but that's not a wiki and therefore it is not easy to contribute to it. Also it has a strict structure.

I already realized the problem, that we also have a documentation for each package at packages.debian.org and a readme file, that comes with the package and so forth. So we'd actually be duplicating that here in the wiki.

"The right place for documenting a software is with the package"

So my question is: What do we want to do at the Wiki ?

It would be nice if there was a function, that could automatically load a package's description into a wiki page. We could then write further information around it.

Is there a mailing list or a communication area for the wiki ?

"If you can write perl, you might want to help improving packages.debian.org"

I probably could, I have been writing PHP for years.

Best wishes from Germany

--- Zikzag, 2009-02-08 16:54

Sikzad said
 * So my question is: What do we want to do at the Wiki ?
That's a good question. I could list what is not ''appropriate'' (["DebianWiki/Content"]), but I don't want to list the other way around.

I wish that some day, Debian (and free software in general) will find an easy way (à la wiki), to contribute improvements to documentations (There was some talks to publish READMEs in packages.d.o, in a wiki like tools, but it hasn't happened yet)...

If you have some ideas, I (and others) would be glad read/see it.


 * It would be nice if there was a function, that could automatically load a package's description into a wiki page. We could then write further information around it.
I would rather see it the other way around (i.e make the content of the wiki page available in p.d.o), IMO.

 * Mailing list
The mailing list for the wiki is [http://lists.debian.org/debian-www debian-www].

Zikzag

about me

I'm just an average young Linux user from Germany

my goals

  • I want to push the German part of this wiki
  • I want a better documentation of Debian and Debian software in this wiki

my doings

  • working on the index of German contents
  • trying to bring a structure to the German tree
  • translating pages from English to German
  • will eventually create new pages

other distros I am or have been using

  • Ubuntu
  • Fedora
  • SuSE

Visitors comments

Hello Zikzag, I have noticed your multiple contribution to this wiki, thanks for that. I'm am pretty sure that German users will appreciate (others too).

I had comments regarding your contributions/goals:

  • trying to bring a structure to the German tree

    • By now, you probably understood that the structure of the German page must be the same as the reference page (i.e english ones). It doesn't mean that it can be changed though !
  • I want a better documentation of Debian and Debian software in this wiki

    • The right place for documenting a software is with the package (especially the manpage, the README* files as well as the package description).
    • If you can write perl, you might want to help improving packages.debian.org.

-- FranklinPiat ?DateTime(2009-02-08T14:50:26Z)

Hallo FranklinPiat,

@"I want a better documentation of Debian and Debian software in this wiki".

I'm especially talking about this wiki here. If you compare the German section of this wiki here to

wiki.ubuntuusers.de

then what you can find here is pretty poor. I think Debian should have a similiar wiki, too, although most Debian users are more experienced than Ubuntu users and don't need that much help. There is already good help on the net like

http://www.debiananwenderhandbuch.de

but that's not a wiki and therefore it is not easy to contribute to it. Also it has a strict structure.

I already realized the problem, that we also have a documentation for each package at packages.debian.org and a readme file, that comes with the package and so forth. So we'd actually be duplicating that here in the wiki.

"The right place for documenting a software is with the package"

So my question is: What do we want to do at the Wiki ?

It would be nice if there was a function, that could automatically load a package's description into a wiki page. We could then write further information around it.

Is there a mailing list or a communication area for the wiki ?

"If you can write perl, you might want to help improving packages.debian.org"

I probably could, I have been writing PHP for years.

Best wishes from Germany

--- Zikzag, 2009-02-08 16:54

Sikzad said

  • So my question is: What do we want to do at the Wiki ?

That's a good question. I could list what is not appropriate (["DebianWiki/Content"]), but I don't want to list the other way around.

I wish that some day, Debian (and free software in general) will find an easy way (à la wiki), to contribute improvements to documentations (There was some talks to publish READMEs in packages.d.o, in a wiki like tools, but it hasn't happened yet)...

If you have some ideas, I (and others) would be glad read/see it.

  • It would be nice if there was a function, that could automatically load a package's description into a wiki page. We could then write further information around it.

I would rather see it the other way around (i.e make the content of the wiki page available in p.d.o), IMO.

  • Mailing list

The mailing list for the wiki is [http://lists.debian.org/debian-www debian-www].


CategoryHomepage CategoryWikiTranslator