Menu
▾
▴
scrollkeeper-devel
|
From: Rich M. <rd...@cf...> - 2000-11-27 19:12:08
|
I have written up some recent experiences with FreeBSD documentation for my column (Silicon Carny) in SunWorld (http://www.sunworld.com). The column also attempts to summarize the aims of the ScrollKeeper and Meta Projects. If you would like to look at the draft I'm submitting, take a look at http://www.cfcl.com/rdm/SC.200012.1. Please send me email (in the next few days) about any problems you notice. I should be able to squeeze in a few changes during final edit... -r -- -- Rich Morin: rd...@cf..., +1 650-873-7841, http://www.cfcl.com/rdm Prime Time Freeware: in...@pt..., +1 408-433-9662, http://www.ptf.com MacPerl: http://www.macperl.com, http://www.ptf.com/ptf/products/MPPE MkLinux: http://www.mklinux.org, http://www.ptf.com/ptf/products/MKLP |
|
From: Laszlo K. <las...@su...> - 2000-11-28 10:26:20
|
Rich Morin wrote: > > I have written up some recent experiences with FreeBSD documentation > for my column (Silicon Carny) in SunWorld (http://www.sunworld.com). > The column also attempts to summarize the aims of the ScrollKeeper > and Meta Projects. > > If you would like to look at the draft I'm submitting, take a look at > http://www.cfcl.com/rdm/SC.200012.1. Please send me email (in the > next few days) about any problems you notice. I should be able to > squeeze in a few changes during final edit... > > -r This link does not seem to work. Laszlo |
|
From: Dan M. <d-...@uc...> - 2000-11-28 16:12:19
|
On Tue, 28 Nov 2000, Laszlo Kovacs wrote: > Rich Morin wrote: > > > > I have written up some recent experiences with FreeBSD documentation > > for my column (Silicon Carny) in SunWorld (http://www.sunworld.com). > > The column also attempts to summarize the aims of the ScrollKeeper > > and Meta Projects. > > > > If you would like to look at the draft I'm submitting, take a look at > > http://www.cfcl.com/rdm/SC.200012.1. Please send me email (in the > > next few days) about any problems you notice. I should be able to > > squeeze in a few changes during final edit... > > > > -r > > This link does not seem to work. Are you using: http://www.cfcl.com/rdm/SC.200012.1 and not including the period at the end? It worked for me yesterday and again just now. Dan |
|
From: Laszlo K. <las...@Su...> - 2000-11-28 17:02:01
|
> > Are you using: > > http://www.cfcl.com/rdm/SC.200012.1 > > and not including the period at the end? > > It worked for me yesterday and again just now. > > Dan Yes. And it still doesnt work. Laszlo |
|
From: <jf...@in...> - 2000-11-28 18:13:15
|
On Tue, 28 Nov 2000, Laszlo Kovacs wrote: > > > > Are you using: > > > > http://www.cfcl.com/rdm/SC.200012.1 > > > > and not including the period at the end? > > > > It worked for me yesterday and again just now. > > > > Dan > > Yes. And it still doesnt work. > A different address worked for me, which I found by backing up to the root and then experimenting in the manner of a bored journalist: http://www.cfcl.com/cfcl/rdm/SC.200012.1 Cheers, John |
|
From: Laszlo K. <las...@su...> - 2000-11-29 11:58:40
|
> > > Are you using: > > > > > > http://www.cfcl.com/rdm/SC.200012.1 > > > > > > and not including the period at the end? > > > > > > It worked for me yesterday and again just now. > > > > > > Dan Cool, I finally managed to read it. Can we get a link to the article when it appears in the magazine itself? Thanks, Laszlo |
|
From: Rich M. <rd...@cf...> - 2000-11-29 16:20:50
|
At 11:58 AM +0000 11/29/00, Laszlo Kovacs wrote: >Cool, I finally managed to read it. Can we get a link to the article >when it appears in the magazine itself? Unfortunately, SunWorld uses some sort of arcane naming system, so I can't predict the exact URL. The column should show up in December, however, and it will be listed in the "Views" area of the main page at http://www.sunworld.com. Whoever notices the piece there should feel free to send a link to the list... -r -- -- Rich Morin: rd...@cf..., +1 650-873-7841, http://www.cfcl.com/rdm Prime Time Freeware: in...@pt..., +1 408-433-9662, http://www.ptf.com MacPerl: http://www.macperl.com, http://www.ptf.com/ptf/products/MPPE MkLinux: http://www.mklinux.org, http://www.ptf.com/ptf/products/MKLP |
|
From: Rich M. <rd...@cf...> - 2000-11-28 18:33:52
|
Laszlo Kovacs wrote: > >This link does not seem to work. Sorry, I've been trying to clean up a problem in Apache, but I seem to have made things worse. Please try it now. http://www.cfcl.com/rdm/SC.200012.1 -r -- -- Rich Morin: rd...@cf..., +1 650-873-7841, http://www.cfcl.com/rdm Prime Time Freeware: in...@pt..., +1 408-433-9662, http://www.ptf.com MacPerl: http://www.macperl.com, http://www.ptf.com/ptf/products/MPPE MkLinux: http://www.mklinux.org, http://www.ptf.com/ptf/products/MKLP |
|
From: Nik C. <ni...@fr...> - 2000-11-29 14:50:09
|
Rich, On Mon, Nov 27, 2000 at 11:09:54AM -0800, Rich Morin wrote: > I have written up some recent experiences with FreeBSD documentation > for my column (Silicon Carny) in SunWorld (http://www.sunworld.com). > The column also attempts to summarize the aims of the ScrollKeeper > and Meta Projects. > > If you would like to look at the draft I'm submitting, take a look at > http://www.cfcl.com/rdm/SC.200012.1. Please send me email (in the > next few days) about any problems you notice. I should be able to > squeeze in a few changes during final edit... I'm keeping the cc's in place for this, because this is something I want to reiterate to the commentators and lurkers on the FreeBSD-doc mailing list (and the various Linux doc people on the ScrollKeeper list will probably agree). We're in complete agreement about the need for better documentation, and the requirement for better searching and indexing tools. Of this latter requirement, I have high hopes for ScrollKeeper (once we've finished batting around some of the design decisions). Your choice of make.conf is perhaps a little unfortunate, as in the past few weeks someone else has had exactly the same problem you had. They also realised that a make.conf manual page would be a good thing to have for the reasons you specify in your article. So, they wrote one, put together a PR (Problem Report, or Patch Report, depending on who you listen to), visible at http://www.FreeBSD.org/cgi/query-pr.cgi?pr=22676 As you can see, this was then kicked back and forth a bit on the mailing list, changes were made, and then it was committed to FreeBSD. So FreeBSD, thanks to the actions of one of its users, now has a make.conf(5) manual page. I don't doubt that there are other areas of the system that need further documentation and explanation. It's an unfortunate fact of life for all of us that there are this > < many things to do, and this > < much time in which to do them. This is why the FreeBSD project is very open to receiving PRs, and I do my level best to bring people in to the doc project as soon as they demonstrate that they can generate good PRs and won't need an excessive amount of handholding. In the recent past this includes people like Bruce Mah Ben Smithurst Mark Ovens Daniel Harris Kazuo Horikawa Hiroki Sato Alexander Langer and many others (Neil, Sheldon, Jeroen, the list is long, and an omission just means I haven't got time to work through CVSROOT/access). This is how the process works -- people find problems, fix them, and submit patches. Sometimes the people finding the problem are already committers, but a lot of the time it's FreeBSD users. And with the best will in the world, a PR with a patch is a hell of a lot easier for a committer to deal with than a message saying that something needs fixing. [ For example, the fact that sysinstall doesn't know about the new documentation packages yet -- I know this is a problem, as do people following this mailing list. But unless someone else steps up to the plate (anyone!) with patches, the problem's going to have to wait until I've got the requisite 12 clear hours to sit down with the sysinstall code and write the glue. ] N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery |