From owner-freebsd-doc@freebsd.org Tue Dec 18 06:06:03 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 9F3DA13421D1 for ; Tue, 18 Dec 2018 06:06:03 +0000 (UTC) (envelope-from yzgyyang@gmail.com) Received: from mail-lj1-x22c.google.com (mail-lj1-x22c.google.com [IPv6:2a00:1450:4864:20::22c]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id AC3AA81B0A; Tue, 18 Dec 2018 06:06:02 +0000 (UTC) (envelope-from yzgyyang@gmail.com) Received: by mail-lj1-x22c.google.com with SMTP id s5-v6so13108213ljd.12; Mon, 17 Dec 2018 22:06:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=YqipuqARnJjMCyWDUSsg3PegD4ymY/avg39tyv66vH8=; b=EErfwSWJ2hTigM1PlELhiQJSkSZF/Adpzbu7WYRsnQSSWI768AKz6AlIZrSTzSVFek J8JjD4MfnAaBFy4FQP6FeRavfIypnBPH/NO0ExFPZZA1O1sPM1BHthPt24qAFBiXt536 skVSGd0oPuLvsv3aDQRn7Pflcx8RrCgqnvejEKHH4oIejTMCGYqcxEA2/JzpYQk2kQ10 sMbvwy/r4OvX9fAMLa9KZNak3uD2hD80jTToV8NtC+ebTqkWoc7gVvJC9mZcOXYHLo+C 5fG/rB1dAWmAZd7jGE2W2ON1FbXBRbqwe8cYia3Y8th7mm8xwtPIR+Q+N2h8cefjwCVB fLrw== 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=YqipuqARnJjMCyWDUSsg3PegD4ymY/avg39tyv66vH8=; b=VD/8YwYL7JUijNcEfzWbFY7lg199Ua4Lo1Sj1DeYJYVqeN6moEzFUL4I14Bm2w3vfK IjJo46EWmmqgFjxT4zLFUvsDfhNhN1DIr++hjwHOsb4SgBDYNGirKS3GLrGh9dw0XCyj SIpHckOFWcRk2vG3fjeqIu69w7oltxP+Odrh4/kf6YElqM8wRvMCpRheZvTMALNFRM2c dADlnhdB1Aud4J1Obcw+P1/ZRRMQ/sXewCyyzWpWWXpXBBzL3YlThr2C+5i3pqS5XZQN m+Nmjpqp3GUjGvFGoMv95AEPvixQxJF/4aYMprt8+PL4Cfw0Bwol+niYfRftqgVzJFQw 7fqA== X-Gm-Message-State: AA+aEWYhP7ODt+BXrjqGG2UT+zM/u9i5W27cwFtHjatrqGtwz0phC6UA 8Gyz+ZuENXBHmzdI+0fNuQwiua+K/3JfO58VzIoPf178 X-Google-Smtp-Source: AFSGD/W/V538dzKYusekPRZfjZRVqD6FdQ7hg5b7KwIkd19Kh8V2rhpryHIP6zkkVFOeYmAw7opPU6+ELjvRUgLambM= X-Received: by 2002:a2e:8ec8:: with SMTP id e8-v6mr8999764ljl.162.1545113160636; Mon, 17 Dec 2018 22:06:00 -0800 (PST) MIME-Version: 1.0 References: <20181217044757.GA94620@kduck.kaduk.org> <7b21f52a-98f3-9169-558b-18f3e03beaa9@FreeBSD.org> In-Reply-To: <7b21f52a-98f3-9169-558b-18f3e03beaa9@FreeBSD.org> From: Guangyuan Yang Date: Tue, 18 Dec 2018 14:05:48 +0800 Message-ID: Subject: Re: Willing to help with documentation To: Benedict Reuschling Cc: Benjamin Kaduk , Nikolai Lvovich , freebsd-doc@freebsd.org X-Rspamd-Queue-Id: AC3AA81B0A X-Spamd-Bar: ------ Authentication-Results: mx1.freebsd.org; dkim=pass header.d=gmail.com header.s=20161025 header.b=EErfwSWJ; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (mx1.freebsd.org: domain of yzgyyang@gmail.com designates 2a00:1450:4864:20::22c as permitted sender) smtp.mailfrom=yzgyyang@gmail.com X-Spamd-Result: default: False [-6.01 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; R_DKIM_ALLOW(-0.20)[gmail.com:s=20161025]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; R_SPF_ALLOW(-0.20)[+ip6:2a00:1450:4000::/36]; FREEMAIL_FROM(0.00)[gmail.com]; MIME_GOOD(-0.10)[multipart/alternative,text/plain]; RCVD_TLS_LAST(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_SOME(0.00)[]; MX_GOOD(-0.01)[cached: alt3.gmail-smtp-in.l.google.com]; DKIM_TRACE(0.00)[gmail.com:+]; DMARC_POLICY_ALLOW(-0.50)[gmail.com,none]; RCVD_IN_DNSWL_NONE(0.00)[c.2.2.0.0.0.0.0.0.0.0.0.0.0.0.0.0.2.0.0.4.6.8.4.0.5.4.1.0.0.a.2.list.dnswl.org : 127.0.5.0]; IP_SCORE(-2.50)[ip: (-9.48), ipnet: 2a00:1450::/32(-1.58), asn: 15169(-1.37), country: US(-0.08)]; NEURAL_HAM_SHORT(-0.50)[-0.501,0]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+,1:+]; FREEMAIL_ENVFROM(0.00)[gmail.com]; ASN(0.00)[asn:15169, ipnet:2a00:1450::/32, country:US]; RCVD_COUNT_TWO(0.00)[2]; DWL_DNSWL_NONE(0.00)[gmail.com.dwl.dnswl.org : 127.0.5.0] Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.29 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Dec 2018 06:06:04 -0000 On Tue, Dec 18, 2018 at 2:03 AM Benedict Reuschling wrote: > > > Am 17.12.18 um 05:47 schrieb Benjamin Kaduk: > > On Mon, Dec 17, 2018 at 01:55:07AM +0530, Nikolai Lvovich wrote: > >> Hi. > >> > >> I am new to the FreeBSD project (using since FreeBSD 11.1), and I use > it as > >> only desktop OS during my university research, for frankly, I am amazed > by > >> the quality and reliability of it, including the friendly handbook. > >> > >> However, I notice a few outdated info now and then in both > >> > >> > >> 1. 1. FreeBSD handbook > >> 2. 2. FreeBSD developer's handbook. > >> > >> > >> I am willing to help the project by updating the handbook. Please let me > >> know if you guys are interested in my request :) > > > > Generally we are, with the caveat that getting volunteers to have the > time > > to look at submissions can require persistence and manual pestering. > > You'll likely want to read > > https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ and submit > > some bugzilla entries > > (https://bugs.freebsd.org/bugzilla/enter_bug.cgi?product=Documentation). > > Feel free to hop on to #bsddocs on efnet as well, whether for > > questions/discussion or to pester people to look at your patches. > > > > -Ben > > Hello Nikolai, > > I'm glad to hear that you want to help out. Benjamin already covered a > good amount of starting points. If you have a list of things or even > just small bugs that need to be fixed, let us know. The "Quick Start" > section in the FDP primer should get you started: > > > https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview.html#overview-quick-start > > If you have any questions or get stuck, let us know. > > Regards, > Benedict I just wanted to add that if you have a larger patch for documentation, it's always welcome (or preferred, by myself) to submit it to Phabricator https://reviews.freebsd.org and add "doc" group as reviewer. I don't think it's documented in FDP yet, but it's something I'm doing right now :) Again, please don't hesitate to ask for help here! Best, Guangyuan