From owner-freebsd-doc Wed Oct 3 11:16:48 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mail-out2.apple.com (mail-out2.apple.com [17.254.0.51]) by hub.freebsd.org (Postfix) with ESMTP id E173337B401; Wed, 3 Oct 2001 11:16:41 -0700 (PDT) Received: from mailgate2.apple.com (A17-129-100-225.apple.com [17.129.100.225]) by mail-out2.apple.com (8.11.3/8.11.3) with ESMTP id f93IGf118982; Wed, 3 Oct 2001 11:16:41 -0700 (PDT) Received: from scv2.apple.com (scv2.apple.com) by mailgate2.apple.com (Content Technologies SMTPRS 4.2.1) with ESMTP id ; Wed, 3 Oct 2001 11:16:37 -0700 Received: from haydenidsl3.apple.com (haydenidsl3.apple.com [17.219.156.124]) by scv2.apple.com (8.11.3/8.11.3) with ESMTP id f93IGZQ07984; Wed, 3 Oct 2001 11:16:35 -0700 (PDT) Date: Wed, 3 Oct 2001 11:16:30 -0700 Mime-Version: 1.0 (Apple Message framework v472) Cc: Nik Clayton , discuss@linuxdoc.org, doc@freebsd.org Message-Id: In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Subject: Re: Proposing some new HOWTOs From: Ronald Hayden Content-Transfer-Encoding: quoted-printable To: Jorge Godoy X-Mailer: Apple Mail (2.472) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org 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 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 >> >> ... >> >> ... >> >> 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. ] > > > :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) > > > 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. > > 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