From owner-freebsd-doc@freebsd.org Wed Mar 1 03:47:01 2017 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id B5F7ACF2BD0 for ; Wed, 1 Mar 2017 03:47:01 +0000 (UTC) (envelope-from pl@catslair.org) Received: from smtpq1.tb.mail.iss.as9143.net (smtpq1.tb.mail.iss.as9143.net [212.54.42.164]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 6C04C79F for ; Wed, 1 Mar 2017 03:47:00 +0000 (UTC) (envelope-from pl@catslair.org) Received: from [212.54.34.120] (helo=smtp12.mnd.mail.iss.as9143.net) by smtpq1.tb.mail.iss.as9143.net with esmtp (Exim 4.86_2) (envelope-from ) id 1ciux0-0000qF-8Y for freebsd-doc@freebsd.org; Wed, 01 Mar 2017 04:29:14 +0100 Received: from 5350c169.cm-6-1d.dynamic.ziggo.nl ([83.80.193.105] helo=breve.losoco.com) by smtp12.mnd.mail.iss.as9143.net with esmtp (Exim 4.86_2) (envelope-from ) id 1ciux0-0003XS-5y for freebsd-doc@freebsd.org; Wed, 01 Mar 2017 04:29:14 +0100 Received: from macron.intranet.lan (macron.intranet.lan [10.0.1.5]) by breve.losoco.com (Postfix) with ESMTP id E9B9DBAB for ; Wed, 1 Mar 2017 04:29:12 +0100 (CET) Received: from PLWin7 (plwin7.intranet.lan [10.0.1.25]) by macron.intranet.lan (8.15.2/8.15.2) with SMTP id v213TC8Z068892 (version=TLSv1 cipher=AES256-SHA bits=256 verify=NO) for ; Wed, 1 Mar 2017 04:29:12 +0100 (CET) (envelope-from pl@catslair.org) From: "Peter Looyenga" To: Subject: Introduction & question / comment regarding source tree documentation Date: Wed, 1 Mar 2017 04:29:38 +0100 Organization: LoSoCo Message-ID: <000001d2923c$117af6d0$3470e470$@catslair.org> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Outlook 14.0 Thread-Index: AdKSOaAFEx0o1fZjQCu335P/kjuyKg== Content-Language: nl X-SourceIP: 83.80.193.105 X-Ziggo-spambar: / X-Ziggo-spamscore: 0.0 X-Ziggo-spamreport: CMAE Analysis: v=2.2 cv=d4GF8VrE c=1 sm=1 tr=0 a=Xo95Qdicdnt3M1YrU9GpoQ==:17 a=kj9zAlcOel0A:10 a=6Iz7jQTuP9IA:10 a=6I5d2MoRAAAA:8 a=UxUYSaZrAAAA:8 a=R3Lbl6lZYZwc32AKbnAA:9 a=CjuIK1q_8ugA:10 a=-nFluOCklqUA:10 a=3Nn4he2mhjkA:10 a=IjZwj45LgO3ly-622nXo:22 a=xulkie6Xo4hBkDACfEOP:22 none X-Ziggo-Spam-Status: No X-Spam-Status: No X-Spam-Flag: No X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 01 Mar 2017 03:47:01 -0000 Hi guys, Disclaimer: I went over the mailinglist archives a little bit but it doesn't help that I don't necessarily like mailinglists and personally prefer the comforts of a web forum. But I'll cope :) I've been using FreeBSD for quite a few years now, I more or less switched from Solaris to FreeBSD. That is: I also have my share of Linux usage, but in general I always considered Linux a decent way of keeping my Solaris experiences fresh (before you could purchase Solaris/x86). Well, we all know what happened to Sun I assume, and that made me fully move onto FreeBSD. I literally never looked back. I'm a bit on and off on the FreeBSD forums, already wrote a decent (?) share of guides, and right now I hope that I can help contribute a bit more to the documentation project. Because one thing which I always admired on FreeBSD was its set of very mature and good to follow documentation. But I'm also starting to spot some issues, so yeah: instead of "complaining" about those I'd like to try and help address those. My current drive: I can't help feel that the steps required to obtain the source tree aren't very well explained, and as a result several people and up confused. To put it more blunt, this thread is what drove me to try and take more action: https://forums.freebsd.org/threads/59919/ I know that 23.4 in the handbook explains how to track the development branches. But what bugs me is that the actual SVN url's are very deeply buried away. A regular user will have to take a lot of effort before realizing that svn://svn.freebsd.org/base/stable is actually pointing to a developer snapshot instead of a stable version of the whole thing. Also: svn://svn.freebsd/base/current isn't even directly mentioned (only -CURRENT, yet without the associated URL) which I think is also adding up to confusing users. I also think it doesn't help that section A.3 (Using subversion) still talks about stable/9 and stable/10 even though 9 is already EOL (see here: https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/svn.html#svn-mirr ors). Although I can absolutely agree that it does serve well as a general example. But I also think it's an oversight not to include examples on how to check out the current stable (RELENG) source tree in the chapter about using Subversion. As such I read up on the procedures which one needs to follow and I'm already getting my hands behind the documentation source. My only concern (and actual question): Is this already work in progress by any chance? I don't mind spending a good amount of time on writing up some documentation, but I have a little bit of a problem with setting something up only to find out that it wasn't needed at all. Note: I don't mind if I send in suggestions and then see them not getting accepted, that's all part of the game. But it would be bad for me when I start working on this, only to discover that someone else was already working on it so I basically ended up wasting my time. Hope you guys can give me some pointers on this. And thanks in advance for any comments you can give me! Kind regards, Peter -- .\\ OpenPGP public key: http://www.catslair.org/shelluser.asc +- S/MIME semi-private Root CA: http://ssl.catslair.org/catslair.crt