From nobody Tue Sep 7 16:51:37 2021 X-Original-To: freebsd-current@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 7BAFB17C3874 for ; Tue, 7 Sep 2021 16:51:56 +0000 (UTC) (envelope-from wschnr@googlemail.com) Received: from mail-lf1-f43.google.com (mail-lf1-f43.google.com [209.85.167.43]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4H3rs8350lz3PYV for ; Tue, 7 Sep 2021 16:51:56 +0000 (UTC) (envelope-from wschnr@googlemail.com) Received: by mail-lf1-f43.google.com with SMTP id m28so20759597lfj.6 for ; Tue, 07 Sep 2021 09:51:56 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=4GptLE+6/97K4RDvaYcvGhMFMh162wVOOhABQbcEHFg=; b=nsjBDRLW4vq/D1i97qpxqTnvwnoN7BGKLfz/eOynf1iDwAtWzCDrjJ+ouk/N9LmjHQ BfmbrEO02ANhutv4J2y8Rj3fpzeTZHCnE14Tm162DKQdpyTJioWqbQXA7Bn1jB7VW9xx tiDO60kEOahzBb3hC4kn7H2r2pzYPFC/E1jZ/W6ubjV9RBRJLrRIc3Qv//3B+5YztdWk ME4oXC2kriv+DtQ31hDV/nMOJQRRGRdRBWK0qeRhKwhAFbRbbnrvDejrd+bSdHz2arUP ClcdaywWl3z6MFo/ATW8uwq0canFIF0HcqHC6S6CSpFEo7SL2qV62EcJqT4CSL9cP/gf pYXA== X-Gm-Message-State: AOAM533LsVqw8qwARvC0xI0fDl0hgGYYaA9/IEE4YhkORgoU0bJHR83s s3nlZzUsRfkVxSvO+zYNLPMmzdL5L39gBtzRBdA= X-Google-Smtp-Source: ABdhPJzvSI0dlIQ1y+Zwkw6Dv/rTiPp/GLB8x9wSgfv+TQ0HDeDtdSKqUyRZ8+sP6SXkw2vbyZUcrgFo25Z5kTWmXbE= X-Received: by 2002:a05:6512:31c9:: with SMTP id j9mr5705511lfe.322.1631033508616; Tue, 07 Sep 2021 09:51:48 -0700 (PDT) List-Id: Discussions about the use of FreeBSD-current List-Archive: https://lists.freebsd.org/archives/freebsd-current List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-current@freebsd.org MIME-Version: 1.0 References: In-Reply-To: From: Wolfram Schneider Date: Tue, 7 Sep 2021 18:51:37 +0200 Message-ID: Subject: Re: Move the Handbook into source tree To: Mehmet Erol Sanliturk Cc: freebsd-current Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 4H3rs8350lz3PYV X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; TAGGED_RCPT(0.00)[]; REPLY(-4.00)[] X-ThisMailContainsUnwantedMimeParts: N We have 3 main repos: src, ports and doc. There are good reasons why we are doing this, and it will not change in the near future. For further questions and details, please ask on the freebsd-docs mailing list. You are right that the documentation on our web site is mostly for -current, the state of the art of the code base. If you need the documentation for our supported releases please check our Documentation Archive at https://docs.freebsd.org/doc/ and select your favourite release, e.g. the handbook for FreeBSD 13.0 https://docs.freebsd.org/doc/13.0-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/ the handbook for FreeBSD 12.0 https://docs.freebsd.org/doc/12.0-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/ -Wolfram On Tue, 7 Sept 2021 at 09:03, Mehmet Erol Sanliturk wrote: > > Dear All , > > in many of my messages to FreeBSD mailing lists I am mentioning the > following view : > > "Please move the Handbook into source tree , and > Maintain it with respect to current release without mixing sliding > releases : If you do this , > maintenance of a correct Handbook is IMPOSSIBLE because maintenance of > associated IF statements about releases . > " > > When we look at the following web pages , we see the following : > > https://www.freebsd.org/cgi/man.cgi > FreeBSD Manual Pages > > In the second box of "All sections" line , there are lines about all of > the FreeBSD releases > with many more other systems . > > In spite of this , in the following page : > > https://docs.freebsd.org/en/books/handbook/ > FreeBSD Handbook > The FreeBSD Documentation Project > > > " > Abstract > > Welcome to FreeBSD! This handbook covers the installation and day to day > use of > FreeBSD 13.0-RELEASE, FreeBSD 12.2-RELEASE and FreeBSD 11.4-RELEASE. ... > " > > A Handbook which ( for me , exactly , for the others , perhaps ) with many > errors ... > > > I think that , it is NOT extraordinarily a difficult process to move the > Handbook into source > tree and maintaining it with respect to per release and insert into the > above web page a part > similar to the manual pages to display the requested Handbook with respect > to releases . > In the present case , previous handbooks are lost , because of the > difficulty of finding them . > > Thank you very much and my best wishes for you and humanity in these > pandemic days ... > > > Mehmet Erol Sanliturk -- Wolfram Schneider https://wolfram.schneider.org