Date: Wed, 3 Oct 2001 11:16:30 -0700 From: Ronald Hayden <rhayden@apple.com> To: Jorge Godoy <godoy@conectiva.com> Cc: Nik Clayton <nik@freebsd.org>, discuss@linuxdoc.org, doc@freebsd.org Subject: Re: Proposing some new HOWTOs Message-ID: <C4A5727B-B82A-11D5-84B2-003065F8968A@apple.com> In-Reply-To: <conectiva-linux.m3bsjxinrn.fsf@godoy.laptop>
next in thread | previous in thread | raw e-mail | index | archive | help
I just got back from vacation, so here is a brief response as I catch up on things... The Darwin team (http://www.darwin.org/) is very interested in such a project, and has offered to provide a server for it. We (those working on this unified doc project) would need to administer the server ourselves. Nik, Murray, and I were discussing setting up a system such that you could build the doc that applied to all platforms, or the doc for a specific platform. Much of the effort would be in getting people to contribute to this project if they are doing "standard UNIX doc", so that all projects would benefit. My personal opinion is that, more important than the ability for a doc project to add some standard doc would be the general website that would inevitably result from this. Having a central website where all standard Unix doc is located, with discussions of platform differences, might be a big benefit to all. The big question is how to get it going given Nik's busy-ness. We were discussing starting with the existing FreeBSD tool chain for producing things, and evolving that over time as possible (in particular, to move away from dependence on the current PDF tools, assuming another more living solution ever comes available; and possibly to one of the more recent approaches to 'make'). As such, hopefully another benefit of this project would be a standard tool chain that any doc project could easily adopt. -- Ron On Wednesday, September 26, 2001, at 03:35 PM, Jorge Godoy wrote: > Nik Clayton <nik@freebsd.org> writes: > >> I've been talking with the folks at Darwin about setting up a > > Excuse me for my ignorance, but what's 'Darwin'? Any FreeBSD team? > >> documentation repository that would contain documentation that is >> either >> truly cross-platform, or that has a minimum of OS-specific content -- >> the sort of thing that can be handled with >> >> <para os="linux">...</para> >> >> <para os="freebsd">...</para> >> >> and so forth. > > That's OK. Just minimal stylesheet customization would handle that > easily. > >> I don't expect that every documentation project's documentation would >> move there (there's a lot of FreeBSD doc. proj. stuff that's totally >> FreeBSD specific) but things like "Unix basics", "How to write a man >> page", and so on would go here. > > That's what I was thinking about. > > These generic guidelines, internet behaviour, theoretical documents, > etc. are perfect for sharing among several projects. Having them > together is "a good thing"(tm). > > My fear is that things come to and end as OSWG. OSWG wasn't OS > specific and it simply vanished. > >> So far, the discussions on this with the Darwin folk have stalled. >> That >> is completely my fault -- my free cycles went out the window >> practically >> as soon as I got back from the US, and I've been working on things that >> pay the mortgage ever since. > > Aren't we all working more than we used too? :-P > >> [ Plug: Skilled SGML / XML / XSLT / Perl / C Unix hacker for hire. >> Preference for working on Open Source projects. ] > > <joke> > :o)) If somebody has more money to spend, and doesn't know what to do > with it, I'd like to get some too. >:o) > </joke> > > OK... Nik needs it more than I do... Hire him. ;-) > >> I don't want this to stumble just because I haven't got the time to >> work on its inception, so I'm sending this in the hope that interested >> parties can take this further. > > I am interested, but I can't assume another project. I can see that we > have some net resources, thought. And I'd like to contribute to it. > > > See you, > -- > Godoy. <godoy@conectiva.com> > > Solutions Developer - Conectiva Inc. - http://en.conectiva.com > Desenvolvedor de Soluções - Conectiva S.A. - http://www.conectiva.com.br > To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?C4A5727B-B82A-11D5-84B2-003065F8968A>