From owner-freebsd-doc@freebsd.org Sat Jul 7 00:09:01 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 33361103F7C1 for ; Sat, 7 Jul 2018 00:09:01 +0000 (UTC) (envelope-from sid@bsdmail.com) Received: from mout.gmx.com (mout.gmx.com [74.208.4.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "mail.gmx.com", Issuer "thawte SSL CA - G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id B0FB6765D6 for ; Sat, 7 Jul 2018 00:09:00 +0000 (UTC) (envelope-from sid@bsdmail.com) Received: from [108.70.50.7] ([108.70.50.7]) by web-mail.mail.com (3c-app-mailcom-lxa14.server.lan [10.76.45.15]) (via HTTP); Sat, 7 Jul 2018 02:08:49 +0200 MIME-Version: 1.0 Message-ID: From: Sid To: clmoonriver@equinedreams.art Cc: freebsd-doc@freebsd.org Subject: Re: Interested in helping with documentation Content-Type: text/plain; charset=UTF-8 Date: Sat, 7 Jul 2018 02:08:49 +0200 Importance: normal Sensitivity: Normal X-Priority: 3 X-Provags-ID: V03:K1:GSd4jcC9Vte93eUgIOMG5U/HUInPZguZCOtn0AoHYv9yzpRWvk7nOKtfF0hArMs4wmPTf 1ljn/lxqLwKYjZQH1z2NtnaJI8AQ9zyk9f/6zQgsGGjW0bqjMq5yRGCHusuT0EUXb2KY1opGfCF7 tvifr7TopitL2zdXlLZTSneAOePo2dT2DFaWv9+oZ1yQUr+BiemvKCGaDaMawyyRVAxykcp7ZudG i2roIXCwBCAYJXJxWgNQY3A9dVRVzd7rPF4NT9Xq2qB6QFMcm2aYzAmMBZFB4WY8sWsJe17XCq0b tE= X-UI-Out-Filterresults: notjunk:1;V01:K0:BiFt9TD34so=:Q0fSGSjq026nlIEzOSMxsN Qq3OX1lvE4A26JKR8hSsiKSK01HkKKo6bx3JSHMLzGzD3PgHQgD1E7yQ7aG79K78BxWf1ORrw sPpxSZw1FHEr6REBNQ1WNzwPoxCgRVOyaLt+mAbOt2qcGP3MO2e0SPFg6DoWC8fEFAROBfEFY CobDl/PpnjIRqbuiScLjRc+B4OB13E7ls+iPRwLBkZoCKl8VKsJblkrqjiUKUSQWN47rLN/eN ARfGQv5vb5CEOZ8JXJy8OmE01mPrEVahnYRf3vK0ahq3CIME4U8JhSbebHrmZk6oWq/YyT3LP G880VRJiFbAHGsS+OyEY8z6C94iq5H9HreyQGpwtkpPHRERRn4PYC1zAyc7z1WAkGcqEA0Ws3 kwpf1l24Mw2DNmZWQ5jhQEi1cTWzBPkjIzF2BdkA4yvBW3otB96dL8aVMIEN9S4+AHvDp7BDw a27SHUZWnRwo0T8AcS0xPCho4ryIUi6a2uQ46ojDm8tUN+ZICNaJniDgfMNvVC8gG3Ro0/JT8 b8gSviSeagsCjXGMkncUGBRmBm4Tg7fHaVXIUx38mEa 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 00:09:01 -0000 The guide is here, https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ , it takes downloading the documentation source code, adjusting your console editor for tabs and spacing, and dealing with igor. Once you get that, submit it to https://bugs.freebsd.org/bugzilla/ I've proposed suggestions, including changing the configuration directory, but they sit there for months. Documentation contributors are understaffed. It is discouraging. https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=224375 I had another one that gave a more detail, gave how to configure the login screen, and took away focus from Gnome, XFCE and KDE for universal settings for any window manager. I deleted that one after it was ignored for even more months, and tried to get the most basic edit in. > 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.