[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Quick reference (First web pages build, what's next?)

On Sun, Feb 10, 2002 at 11:11:18AM -0800, Osamu Aoki wrote:
> > > Thank you for letting me upload "Quick Reference".  It is almost 1MB of
> > > SGML codes in en, fr, it locales. 
> > 
> > And you call that "quick"? :)
> That is the biggest headache for me.  I wanted a 30 page document but
> ended up with 100 pages. Most topics are covered in 1 to 2 screens on
> VT-100 or 1 page on paper.  Topics can be big topics, such as, how to
> compile a new kernel or how to upgrade APT from potato to woody while
> setting /etc/apt/preferences and /etc/apt/sources.list.  So it is
> "quick" in this sense.

Well, perhaps just "Debian Reference" would be suitable. It's really not
quick if it's got a larger index than some other documents have contents :)

> > > This is an administrator and/or user manual.
> > 
> > Yes, and it should be branded as such, and replace the past attempts.
> Thanks but mine is just a "quick reference".  This should not supersede
> any good descriptive manuals.

I said attempts, not good descriptive manuals <shrug> What we currently have
is quite inferior.

> Informative documents for specific topics: 
> * Debian META Manual

Oh, I didn't know this was being updated. It seems as if it replaces the
www.debian.org/doc/ddp pages, and I don't see much point in that...
And the name "META Manual" is bad, most people won't understand what's it
about it instantly.

> Questionable contents:
>   --- Keep these just as archives and no links from front pages: 

I'd prefer to keep them listed but clearly marked as bad.

> ? The Debian Linux User's Guide: 
>   HTML only and unreachable.  If reachable, it may be nice 200+ page
>   document.  Is this DSFG compliant licensing?

Yeah, someone also reported it's missing. Try asking Dale?

     2. That which causes joy or happiness.

Reply to: