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=20= on things... The Darwin team (http://www.darwin.org/) is very interested in such a=20 project, and has offered to provide a server for it. We (those working=20= on this unified doc project) would need to administer the server=20 ourselves. Nik, Murray, and I were discussing setting up a system such that you=20 could build the doc that applied to all platforms, or the doc for a=20 specific platform. Much of the effort would be in getting people to=20 contribute to this project if they are doing "standard UNIX doc", so=20 that all projects would benefit. My personal opinion is that, more important than the ability for a doc=20= project to add some standard doc would be the general website that would=20= inevitably result from this. Having a central website where all=20 standard Unix doc is located, with discussions of platform differences,=20= might be a big benefit to all. The big question is how to get it going given Nik's busy-ness. We were=20= discussing starting with the existing FreeBSD tool chain for producing=20= things, and evolving that over time as possible (in particular, to move=20= away from dependence on the current PDF tools, assuming another more=20 living solution ever comes available; and possibly to one of the more=20 recent approaches to 'make'). As such, hopefully another benefit of this=20= project would be a standard tool chain that any doc project could easily=20= 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=20 >> either >> truly cross-platform, or that has a minimum of OS-specific content -- >> the sort of thing that can be handled with >> >> <para os=3D"linux">...</para> >> >> <para os=3D"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. =20= >> That >> is completely my fault -- my free cycles went out the window=20 >> 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=E7=F5es - 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>