From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Jason@zx2c4.com Received: from krantz.zx2c4.com (localhost [127.0.0.1]) by krantz.zx2c4.com (ZX2C4 Mail Server) with ESMTP id 0c1746ff for ; Sun, 3 Dec 2017 13:57:11 +0000 (UTC) Received: from frisell.zx2c4.com (frisell.zx2c4.com [192.95.5.64]) by krantz.zx2c4.com (ZX2C4 Mail Server) with ESMTP id c5d14334 for ; Sun, 3 Dec 2017 13:57:11 +0000 (UTC) Received: by frisell.zx2c4.com (ZX2C4 Mail Server) with ESMTP id 6a2ce8cf for ; Sun, 3 Dec 2017 13:57:11 +0000 (UTC) Received: by frisell.zx2c4.com (ZX2C4 Mail Server) with ESMTPSA id 24cd2f04 (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128:NO) for ; Sun, 3 Dec 2017 13:57:11 +0000 (UTC) Received: by mail-ot0-f175.google.com with SMTP id o23so12685177otd.1 for ; Sun, 03 Dec 2017 06:03:42 -0800 (PST) MIME-Version: 1.0 In-Reply-To: References: From: "Jason A. Donenfeld" Date: Sun, 3 Dec 2017 15:03:41 +0100 Message-ID: Subject: Re: Dealing with list volume To: Ferris Ellis Content-Type: text/plain; charset="UTF-8" Cc: WireGuard mailing list List-Id: Development discussion of WireGuard List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , On Sat, Dec 2, 2017 at 12:01 AM, Ferris Ellis wrot= e: > Wikis: As for wikis, I always have had mixed feelings about them. For lar= ge > projects like Gentoo or Arch they=E2=80=99re great, in my opinion, for co= mmunity > knowledge accumulation. But for smaller projects I=E2=80=99ve found havin= g something > to the effect of a community maintained `docs/` directory with markdown i= s > just simpler and easier. Plus you can always go back and generate some > pretty webpages out of the `docs/` markdown files if you=E2=80=99ve reach= ed the > adoption level where people expect documentation to be in webpages. This is what I currently have for the wireguard.com page. I should really open source that repo. I could certainly use some more documentation, but nobody has stepped up to create it.