From nobody Tue Jan 02 04:09:12 2024 X-Original-To: freebsd-doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4T3zrB6Nz3z568Y2 for ; Tue, 2 Jan 2024 04:09:14 +0000 (UTC) (envelope-from kolusion@post.com) Received: from mout.gmx.com (mout.gmx.com [74.208.4.201]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "mout.gmx.com", Issuer "GeoTrust TLS RSA CA G1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4T3zr96cVqz4c4L for ; Tue, 2 Jan 2024 04:09:13 +0000 (UTC) (envelope-from kolusion@post.com) Authentication-Results: mx1.freebsd.org; dkim=pass header.d=post.com header.s=s1089575 header.b=Q0orkXly; spf=pass (mx1.freebsd.org: domain of kolusion@post.com designates 74.208.4.201 as permitted sender) smtp.mailfrom=kolusion@post.com; dmarc=pass (policy=none) header.from=post.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=post.com; s=s1089575; t=1704168552; x=1704773352; i=kolusion@post.com; bh=u7bsb6zQXMxnghHhh/dIUeBvp3huiECyptAzWsTEHgA=; h=X-UI-Sender-Class:From:To:Subject:Date; b=Q0orkXlyeNj8MsUpk8XvAO/lbJad3KQ3Ub3tfPTuYRZyS3yDmDiP1n/WIePlpWji MuZ+vlVrrxatJ8BfI2iLQko4wSQhC5Qys/653bbIkoO83cVqQiQb0kSpYr3qQkLbX RhxhAkgsDwzRsM2oMCRvBPT5cUT+jacgVgnALPY9W8X7gXjujPbWf9A0SlYbvdOie uhPywDXOHxd3FjjzF8oMq9A/bd0Xe/S6mgrmoIwpUP1sP350R2qRYJd/DipVmQ4qy fPoDn2lWrM4CqpoAI240EmU6j1V8gEsOAw0fGH2f/VP0r9upOiEUe5IiXK6yA0waH G+rYJCsdNzvvB3ch3g== X-UI-Sender-Class: f2cb72be-343f-493d-8ec3-b1efb8d6185a Received: from [10.237.67.2] ([10.237.67.2]) by msvc-mesg-gmxus001.server.lan (via HTTP); Tue, 2 Jan 2024 05:09:12 +0100 List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 Message-ID: From: Kolusion K To: freebsd-doc@freebsd.org Subject: Improvements for the future FreeBSD Handbook Content-Type: text/plain; charset=UTF-8 Importance: normal Sensitivity: Normal Date: Tue, 2 Jan 2024 05:09:12 +0100 X-Priority: 3 X-Provags-ID: V03:K1:h/YYdjtQs0IPvCOWumSGe60mprLA49Tj/f4RPojHPPHiswaXS6dChUL4kJ8KBXiGlFIJX Q/ANlvQcZgldcLUW3j4sJvMTiCsNFkw/XOBuCy2aY3zU7pUPdpwv3n7SpGX3LMTDR9e4qWkotZU2 BqAqVMRx21XNKCERxnOx7h2nU5ec9edn5V93I+SYomo0Iu9aV/B8vATAQarMHIqLNNJJALO8yx/f GG8zqCBNSvhL8gGwwhO3BrLLZsBRDris+TxNiHlZ+3okC7KrFF7vcophW/MSdw4Wnw8opxDfpbsS YY= X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:IWU/nEymRc0=;Q0tjbWY7TzsSy1i4s8MyNeDmAM4 TUuqAifWHnaWmlnF+D6lqZ0zYxClgZhmOf1QwC6xl0Tay0FY7nKBojO7W7V21Mfg1xo2fyJlv J8THEM0dXNOpJBP+xdnOpgs2/ShdSdVQZhdpQSTrJIFRFxn/huX5xrb8CA/HXCszJq/pUChO2 eWj+6os0fmWdZFGcim/rGBd+MuNB1C4X/vZB2g0KcXo87p2ZahCKIlp2BozSzt4xIHOg+PmPi cr1YjclCqGvcmvfgGdR+u5rRCaOuGk3YGn00MEcejB3Ot5fNKh06KktYo1FipATMcPmHlT2EV cfOgk0M1V1LGlikzaJt7yAiqbzT4Dgkb10EQmCvI/KSYZg4/X1meTG6A/iJzRHZHNSAiGlkYB 5dJwwW2jJ0Hkz82JrT3EUpewLwzrZqL4nmi57q/bNYSIYt0ueQEoU1uDEsJspQLR5MESEl5Bf FcuY0y7oS7A9WHUXMJPnMxKw38Z0vcQW+cQbp1c1szqz9fNH5R+zbpcfcWrLnE2R6r3V3rfZp /1rv+D3pMzftiEZasdyvS8WUhFrqI9oGGv8OxmXlnttYdTp/L/911G6WUwBIo8ttPm1GSqxhU 1cErq1kvGZEtb3ZvWkym5NGuC40G/F0A41yRJ9hp3clEgqLes5dZ/iJJiSv5ZkKraVwmJqCYz fqVOjAolsDi7xN6Vd4qMKk73rD05bKe+V6sESxyhDihHyPVfrX/FSjWYlMOJRN4BtptEtBzmZ HLUFAhq9S2wmQ2Za5GtKVTv9wFw2utoQUn9g81NmJTtcctfRjLiovvqQFSjspPwzc6a8xvwWP qfGEEfyUP7IZoSCMKB4Fl1VQ== X-Spamd-Result: default: False [-3.50 / 15.00]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_SHORT(-1.00)[-1.000]; MID_RHS_NOT_FQDN(0.50)[]; DMARC_POLICY_ALLOW(-0.50)[post.com,none]; R_SPF_ALLOW(-0.20)[+ip4:74.208.4.192/26]; R_DKIM_ALLOW(-0.20)[post.com:s=s1089575]; ONCE_RECEIVED(0.10)[]; RCVD_IN_DNSWL_LOW(-0.10)[74.208.4.201:from]; MIME_GOOD(-0.10)[text/plain]; RCPT_COUNT_ONE(0.00)[1]; TO_MATCH_ENVRCPT_ALL(0.00)[]; RCVD_TLS_LAST(0.00)[]; FROM_HAS_DN(0.00)[]; MLMMJ_DEST(0.00)[freebsd-doc@freebsd.org]; ASN(0.00)[asn:8560, ipnet:74.208.0.0/16, country:DE]; RWL_MAILSPIKE_POSSIBLE(0.00)[74.208.4.201:from]; HAS_X_PRIO_THREE(0.00)[3]; DKIM_TRACE(0.00)[post.com:+]; TO_DN_NONE(0.00)[]; ARC_NA(0.00)[]; RCVD_COUNT_ONE(0.00)[1]; MIME_TRACE(0.00)[0:+]; FROM_EQ_ENVFROM(0.00)[]; FREEMAIL_ENVFROM(0.00)[post.com]; FREEMAIL_FROM(0.00)[post.com] X-Rspamd-Queue-Id: 4T3zr96cVqz4c4L X-Spamd-Bar: --- Hi I have been reading the current FreeBSD Handbook. Much of it is straight the point which I appreciate, but I have found a substantial amount of irrelevant information in it. For example, the document includes sections Third Edition, Second Edition (2004), and First Edition (2001). These sections cover new concepts introduced in previous editions of the FreeBSD Handbook, but they are not part of the abstract of the current FreeBSD Handbook and therefore they don't serve the current FreeBSD Handbook any purpose. I have noticed there is a severe quality control problem with the FreeBSD Handbook in which it appears people haven't tested it to confirm its in line with implementation. So, I think there should be a quality control process for the next publication where sections of the book be given to people to test and confirm implementation. I'd volunteer to be one of these people. Also, I think someones going to have to proof read the FreeBSD handbook back to back to get an overall picture of it because there is a lot of contradiction in it. It will be a big job. The FreeBSD Foundation might have to pay someone a reasonable amount to do it, but I think the result would be worth it. I suggest the future FreeBSD Handbook include a relevancy in its names because the FreeBSD Handbook of yesterday isn't the FreeBSD handbook of today and there isn't a indicator on the face of it to indicate its relevancy. I suggest the naming scheme be intuitive, so, for FreeBSD 15-RELEASE, I'd call the handbook the FreeBSD 15-RELEASE Handbook. Also, there is a problem with the current FreeBSD Handbook where both the fourth edition and third edition sections claim to be the current version of the FreeBSD Handbook. Cringe. Sincerely, Kolusion