Re: Debian Documentation
> On Thu, Dec 02, 2004 at 10:23:12AM +0100, Thomas Albrecht wrote:
> > Hi there,
> > on debian.org i was reading that help is needed for the documentation
> > project. how can someone help? the documentation seems very old (at
> least
> > the german one, the english one is a bit better, but still not up to
> date it
> > seems).
>
> Can you be more specific about this.
Some parts of the documentation depend on Potatoe. Other parts are marked as
"has to be updated" or "please be more specific"; something like this.
(Debian Reference)
If you read the translation its not exact the same version as the original
one. Its not up to date.
How can be assured that the different languages explain the same base?
> > How can be assured that old documents get deleted? when i started with
> > debian it was hard to decide where to start and what to do. I was using
> the
> > gentoo documentation to get a better overview over linux... thats sad.
> > gentoo has one document for each system structure. so there is only one
> > place to start.
>
> Interesting
So, what about a Link for Linux starters? It was very hard to decide which
distribution to choose, what programs to use.
For example at first I was compiling the kernel the "normal" linux way (make
clean, etc.). Then I found out that there is an easier debian way.
Or software. In the beginning I got very confused about all these different
software names. There is so much you can choose from so it's hard to find
the matching software for your problem. It would be nice to have a mapping
>from Windows/MAC/etc. software to Linux software.
At least an description how to find the software. When I started I did not
read the APT-GET documentation because I did not know what it is used for.
What about a startup guide. What is Linux, how to choose my distribution
(and what is a distribution), which install guide to use (not the
description itself maybe a reference), what programs to use, how to manage
my software (maybe with links).
Just a simple single Page or document where you can start from.
Maybe explain the support system - where to find help. and and and. I got so
many ideas when I ran into these problems ;-)
> > if i can help you with anything regarding the docs just mess me. I have
> no
> > idea who to conact or how this process is working... thanks.
>
> If you send patch to the source to the BTS, I think it is likely to be
> included.
>
> Osamu
Sorry, but what is a BTS? And what documentation to change? The "leading"
one should be the english one i guess.
But what about the things i mentioned above? If I'd like to create such a
document for starters, can I simply do this and send it to you? how does
this work? thx for help.
greets,
tom
Reply to: