Date: Mon, 10 Jan 2000 21:45:22 -0700 (MST) From: John and Jennifer Reynolds <jjreynold@home.com> To: freebsd-doc@freebsd.org Subject: pr's for man pages to "doc" Message-ID: <14458.46434.653981.990176@whale.home-net>
next in thread | raw e-mail | index | archive | help
Hello all, While trying to learn more about the FDP, I read the following web page once again: http://www.freebsd.org/docproj/doc-set.html which states the following about system man pages: The Project does not really concern itself with these, since they are a part of the base system. .... That is not to say that the manual pages are unimportant, far from it. It is just that they are intimately tied to specific systems of FreeBSD, and most of the time the best person to write the manual page is the person that wrote that part of FreeBSD. This leaves me a bit confused about PR's to man pages. Should PRs with man page patches be sent in under a different category than "docs"? "misc"? I figured that one of the quickest ways I can actually do something for this project is to once-over man pages, look at PRs (open) dealing with man page issues, and try to improve existing man pages where I know they lack (or things might have been explained just a hair better and thus it might save a newbie some hair follicles). I recently sent in PR docs/15980 with a small snippet to rc.conf.5. I'm just wondering if I should send future man updates (if I can do more :) under a different PR category, or what? This goes along with another post I made from work today about "low-hanging fruit." I'd consider small patches to man pages which "add some value" low hanging fruit. Do committers in the FDP look at PRs related to man pages or is that left for other committers (and do those other committers say "oh, I'll leave that one for the doc boys" and we have a catch .22)? Trying to learn to contribute, and I wanna get things straight in my mind :) Thanks, -Jr -- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= John Reynolds Chandler Capabilities Engineering, CDS, Intel Corporation jreynold@sedona.ch.intel.com My opinions are mine, not Intel's. Running jjreynold@home.com FreeBSD 3.4-STABLE. FreeBSD: The Power to Serve. http://members.home.com/jjreynold/ Come join us!!! @ http://www.FreeBSD.org/ =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 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?14458.46434.653981.990176>