Subject: Re: Another Manual ???
To: Tim Rightnour <root@garbled.net>
From: Federico Lupi <flupi@mclink.it>
List: netbsd-advocacy
Date: 01/20/2000 01:13:15
On Wed, Jan 19, 2000 at 12:17:35PM -0700, Tim Rightnour wrote:
> 
> On 19-Jan-00 Andrew Crossley wrote:
> > Posted on this list due to Herb Peyerl's advice.
> > 
> > Hello NetBSD people,
> > 
> > Andrew Crossley from Perth, Western Australia here.
> 
> >>        Federico Lupi has produced a new user guide for NetBSD in Italian.
> >>
> >>                http://www.mclink.it/personal/MG2508/netbsd/netbsd.html
> >>
> >>        We would like to get this translated into English (and later
> >>        other languages).
> 
> I think this is an excellent project for people to be undertaking..  and I
> think NetBSD as an organization should be attempting to organize what people
> are doing.
> 
> #1 Federico Lupi has written an italian userguide.. which we need to translate.
> #2 Andrew, and others have recently volunteered to write better manuals.
> 
> What I really think we need here, is rather than producing n texts, that those
> of you working on this collaborate on this.
> 
> That being said..  if netbsd is willing to host a private majordomo list for
> this.. I'd be willing to administer said list, and attempt to coordinate a
> single project.
> 
> So I guess the first thing to ask is.. would people be willing to work together
> on such a project?  I realize Federico is italian, and that is his primary
> language, but I think that barrier could be overcome.
> 
> I think at this stage.. trying to hash out a project this large on a public
> list will only lead to disaster.. as the infamous kitchen-sink effect starts to
> set in.
> 
> As far as what my role in this would be.. I'd be offering to admin the list,
> coordinate who is doing what, play arbiter and make sure a common goal is set,
> and offer technical advice on NetBSD itself.
> 
> ---
> Tim Rightnour <root@garbled.net>
> NetBSD: Free multi-architecture OS http://www.netbsd.org/
> NetBSD Mailing lists on the web: http://mail-index.netbsd.org/
> 

My guide started as a collection of fragments that I wrote mostly
for myself but now I have written an article on NetBSD that will be
published in a future issue of the Italian magazine "Login" and I
decided to collect everything in a single document to give a some help
to the interested italian readers.  The idea behind my current work
is to help someone with a basic knowledge of Unix to install and
configure NetBSD on i386 and end with a working system.  The guide is
written in SGML/DocBook format (using the SGML mode of vi :-)  )

I am updating the guide frequently on my web pages and it is now
approximately 100 printed pages long.  There is still a lot of work
to do but I think that at this point it is beginning to be useful.

I would be happy if my work could be the starting point for a more
comprehensive effort to produce a newbie documentation suitable for
NetBSD.  A translation of the guide has started, with the help of
Tracy J. Di Marco White, but I don't know the current stage of the
work.

I don't believe very much in "definitive books": they are very rare
and from my experience, I believe that starting with a modest goal is
better:  once a framework for a simple handbook exists I am sure that
contributions, corrections and enhancements will come from all NetBSD
users.

I am willing to help and accept help from anybody but, whatever happens,
I will continue the work on my guide.

-- 
Federico Lupi

Home page: http://www.mclink.it/personal/MG2508/
NetBSD guide: http://www.mclink.it/personal/MG2508/netbsd/netbsd.html