From owner-freebsd-doc@freebsd.org Thu May 11 02:58:37 2017 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 4CBEFD676F8 for ; Thu, 11 May 2017 02:58:37 +0000 (UTC) (envelope-from stievenard.david@gmail.com) Received: from mail-pg0-x22a.google.com (mail-pg0-x22a.google.com [IPv6:2607:f8b0:400e:c05::22a]) (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 1D880B67 for ; Thu, 11 May 2017 02:58:37 +0000 (UTC) (envelope-from stievenard.david@gmail.com) Received: by mail-pg0-x22a.google.com with SMTP id u187so7205399pgb.0 for ; Wed, 10 May 2017 19:58:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:subject:to:message-id:date:user-agent:mime-version; bh=J0mp0Iq/tPsYMQB2dfGjotFifCXC/p7eCWAzTYvIEYw=; b=f5izty4fH87O+BYMOQj07a3YgyacEVAZcFihUV8J++90iOFGx/5+BDx6B1M2SqH4n5 vZG6zx8r4Yq11QHRx3kSAVui9Xm64Th4ZP7OvsbVUfJal0K45HyROfXKu4LE9akvsAA6 bxWlZWdEUl9qwFzIlqfTUsZ0P8t9iFQQWqTk4QzEZXyEduookUWpO2UKC3MZk9gMU/ZA YY3buyY4KV895Gg/1MAlYaTN5RcKxrimzeY8OthgAmpI8MK19u2Ar/SGpW/yMCSjcykO ffis0qNxIHbiAnPHn6kIIEb1TNjNezN1UUVQfQ2WVi5ZQoBP+Btoc6oQPD0q3zyTlc9Q xYgw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:subject:to:message-id:date:user-agent :mime-version; bh=J0mp0Iq/tPsYMQB2dfGjotFifCXC/p7eCWAzTYvIEYw=; b=Kj3Js+yHaPAIwiII/89SyTnyU4e2qHXcN/gyrxDdrph9DnyuegywaCyRcYETqeyxAQ mfWRUAjUW2hSYDkHtRFXtFJSelEVo9sfi8L8pN15FfxeDIw9qc15q/+AnWMt1Ml6Z28L ES49OfxHKB4FHy3f1m8Sn+XuQaNliuFgbDimYZACBehmmraqmrHUZ8aQA+ZJwzJcvwf0 b9u/DH0BKvhR6lKOxkurNtExBjdFhEE1sHtdLiZi665v5tKZZ4HXE+dhM0YmmjPEL2Zi NNT6Y05MxK35Hal0CaaszcEwI+tEDR3GvHWoddanmPXRfBjzzYIiWJ/tPyZYhmZ9UsRQ TJVQ== X-Gm-Message-State: AODbwcCWnyWqPfobDqn/PdU+CyDUbY9y7+1yzburncFQa+Eo9tEhYrV7 hX4RxX5Fm9pkKwi4 X-Received: by 10.99.124.68 with SMTP id l4mr7096993pgn.175.1494471516440; Wed, 10 May 2017 19:58:36 -0700 (PDT) Received: from [198.18.53.142] ([60.249.94.199]) by smtp.googlemail.com with ESMTPSA id x80sm437398pff.105.2017.05.10.19.58.34 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 10 May 2017 19:58:35 -0700 (PDT) From: David STIEVENARD Subject: a howto section in the freebsd wiki ? To: freebsd-doc@freebsd.org Message-ID: <40540c06-c07d-a65d-b718-438ed33fae21@gmail.com> Date: Thu, 11 May 2017 10:58:43 +0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.23 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 May 2017 02:58:37 -0000 Dear eminent members of the FreeBSD documentation mailing list, I started to use freebsd 3 years ago in order to create small IT infrastructures for the company I work for. I'm more into networking but I had to get more familiar with a *nix operating system to I tried linux and freeBSD at the same time, and this last one has my preference (but I'm still a beginner). I'd like to create a "howto" section in the FreeBSD wiki to document installation of applications. *Why ?* wiki - I want to share few tutorials I wrote for myself in blood and tears i.e. a small (out of date) tutorial I wrote https://forums.freenas.org/index.php?threads/install-deluge-in-a-jail.28778/ - use the collaboration feature of a wiki to have docs as up to date as possible. Another differentiator : up to now I'm still amazed to see that what is available in the portstree is quite up to date, I think it just needs a bit of documentation to make things more approachable - I'd like to get experimented users to review, comment, improve - I'd like to invite people who already write howtos elsewhere to come write into the wiki centralized/official - when I started up digging into linux and freebsd, the main differentiator for me was that, being alone, I have less things to learn to achieve tasks with FreeBSD, and the handbook is the foundation of that. - In it's current form having, let's say, a "how to install samba 4.6.2 as an active directory on FreeBSD 11" or "how to install the " doesn't seems right, but I still need it...So I'd like to follow the same "centralized" philosophy and complete the handbook with this kind of documentation in a wiki. *Question : * - The wiki is targeted to developers, so is that OK to write pages for newbies ? - note : It's my first time using a wiki but I see some limitations in moinmoin - bold characters in a code section seems impossible to do at the moment - as seen on https://moinmo.in/HelpOnFormatting -> "the wiki markup is ignored" - I tried the with the parser feature -> fail - contacted the moinmoin team on IRC -> seems impossible to the one who answered me - no way to discuss about a page ? - i.e. in mediawiki https://www.mediawiki.org/wiki/Project_talk:Sandbox - no "thanks" system *My suggestion : *- start on wiki.freebsd.org in it's actual form - I'll need some help to get some details fixed - naming conventions for the howto pages - create a howto start page - which convention to use to specify the status of a page : writing in process / testing / waiting for validation / validated ? - see how it evolves As a demonstration of what it could look like, here's a partial draft -> https://wiki.freebsd.org/DavidStievenard thanks for reading me, dasti