From owner-freebsd-doc@freebsd.org Sat Jul 7 18:18: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 BE641103E1E1 for ; Sat, 7 Jul 2018 18:18:02 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-yb0-x236.google.com (mail-yb0-x236.google.com [IPv6:2607:f8b0:4002:c09::236]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 5A64083E9E for ; Sat, 7 Jul 2018 18:18:02 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: by mail-yb0-x236.google.com with SMTP id s1-v6so5774689ybk.3 for ; Sat, 07 Jul 2018 11:18:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=ev/QXG4giTt6K66HaQjI9/GQ79HbzlSKUx0YhQKH+ZA=; b=rPG9ZaF45e/7K2TZnS4Ksc6TbmuSGFGyeq7VUwum9NuQdzKLJ5Icl0dEIcpsnN6Um+ stWUXBzM+97ZcmioB1zcORuc1jDMjODw8r+b906+jNPqfSXvVhQS0tc7/S050JT9OASW 1oGt8B1I+lSshFKB1wg6TC9de3cA1dflm/pNU= 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=ev/QXG4giTt6K66HaQjI9/GQ79HbzlSKUx0YhQKH+ZA=; b=MLMlMGsiicSY1IAOhAA6BWtFFsM/z0ouXSYpIw625W0rTFABH/F9QtyCy1CSyVfFGs OuD1mhG/UaVIfo/QH73vZJLiE6q7tGeR+zIag9gfqVaQX1GLgmXWppKixoD2Io5Tx1JE +6R8udWawvGmnbCOEeqNy+ux9x3P9OT+/ye/+6t+e54J5wzTaeghEAQm+cuhz06Gg2Ig 1ksXnXGY3hjzHaU+/XW45rNvGUvtbTMX0BoyATkzMCGJhZ+dn5n9wAspO0/t+Sd2Nrnd gwav2wuxUxLyi8UBSKke4O0pt+qvjgMsU5dkVRv/282OEI6M3c7GMcLI+LYmwzFmLM4l +bQw== X-Gm-Message-State: APt69E03RRAUGS/j8EEYWKV092HfzQZgRLViOc/xwAH1YqTEDlWtaS6e 5UcODA2A9PjodfKuySOL8Dd8cwGJdDVOtC0pSRpddQ== X-Google-Smtp-Source: AAOMgpdfLS003KhjJULh9ySiAk6+aDlscdbDE2rX1WfNQq/+ITHdv/WwfAFxwDUmRPS6cjtwpWpYEdYwlKqyHZruKrA= X-Received: by 2002:a25:4546:: with SMTP id s67-v6mr7874380yba.89.1530987481254; Sat, 07 Jul 2018 11:18:01 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Eitan Adler Date: Sat, 7 Jul 2018 11:17:35 -0700 Message-ID: Subject: Re: Interested in helping with documentation To: Sid Cc: clmoonriver@equinedreams.art, "freebsd-doc@freebsd.org" Content-Type: text/plain; charset="UTF-8" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 07 Jul 2018 18:18:03 -0000 On Fri, 6 Jul 2018 at 17:09, Sid wrote: > > > I'm pretty new to the community, but I'm interested in helping out in > various ways. I don't know that there's a lot I can contribute yet > (being so new), but I have noticed there are places in the documentation > that are out of date and I could fix. For example, section 5.6.1 lists > the Xorg xdm config files as being in /usr/local/lib/X11/xdm which it > seems they are not in newer versions of FreeBSD. I found them in > /usr/local/etc/X11/xdm. So at least when it comes to noticing errors > like that, and fixing them, I think I can contribute. > > > I know the basics of Docbook and version control, so if there is a > preferred way to submit corrections using diff files or something, I > should be able to pick up on that fairly quickly. > > > Anyway, I'd love to help out, and just looking for some guidance on how > to get started. Sid gave you the correct links to get started. I will also echo that the documentation committers are understaffed. That said, I wouldn't take it the way Sid has: it does take some chasing of people to get commits it, but it means that even small-time contributions can have a big impact. Also, while my development computer is dead, and thus I can't commit to much right now, I take mentoring new people to be much more important than my own commits: if you submit patches I'll try to review and commit them ASAP. -- Eitan Adler