From owner-freebsd-ports@freebsd.org Tue Jan 3 17:16:31 2017 Return-Path: Delivered-To: freebsd-ports@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 028E4C9DC3F for ; Tue, 3 Jan 2017 17:16:31 +0000 (UTC) (envelope-from vlad-fbsd@acheronmedia.com) Received: from mail.irealone.com (xoth.irealone.hr [136.243.79.146]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id C025216CB for ; Tue, 3 Jan 2017 17:16:29 +0000 (UTC) (envelope-from vlad-fbsd@acheronmedia.com) Received: by mail.irealone.com (Postfix, from userid 58) id 37C1675AA; Tue, 3 Jan 2017 18:16:27 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on postfix.xoth.irealone.hr X-Spam-Level: X-Spam-Status: No, score=-100.0 required=5.0 tests=ALL_TRUSTED, LOCAL_TO_FBSD_PORTS autolearn=ham autolearn_force=no version=3.4.1 Received: from mail.irealone.com (unknown [10.0.0.10]) by mail.irealone.com (Postfix) with ESMTP id CD04975A6 for ; Tue, 3 Jan 2017 18:16:26 +0100 (CET) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Date: Tue, 03 Jan 2017 18:16:26 +0100 From: "Vlad K." To: freebsd-ports@freebsd.org Subject: Re: Ports' tips and gotchas Organization: Acheron Media In-Reply-To: References: Message-ID: <76519193d791325700c3beb34b8f447b@acheronmedia.com> X-Sender: vlad-fbsd@acheronmedia.com User-Agent: Roundcube Webmail/1.2.3 X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 03 Jan 2017 17:16:31 -0000 On 2017-01-03 17:43, Adam Weinberger wrote: > > pkg-message needs to contain only essential information, otherwise > end-users will start to ignore them. I agree that tips should be > shared, but putting it into SVN isn't the way to go. That's something along the lines of what I was thinking, but wasn't sure. Indeed if we start adding tips to pkg-message, where's the end of it. However, in the case of my Postgres patch, it's something the user should be aware of BEFORE they do the initdb step, as once initialized, you can't change it for that cluster, without dumping the database, re-initializing and restoring, that's why I wanted to add it there. Unfortunately, random blogs and websites are not good enough because the information is "out there" and not immediately presented. However, now that you mention it, adding wiki entries and then having a pkg-message contain something along the lines of "Please consult https://wiki.freebsd.org/Foo/Bar for important information before you init/start/configure/migrate/update, ..." is a valid alternative and I like it. In fact, I'll be reworking my Postgres patch to do just that, and create an entry for Roundcube. However, what would be the best way to approach this via the FreeBSD wiki? I'm sure that random wiki pages in various users' namespaces is not quite the right thing to do. There currently are some ports Wiki pages but they're all over the place and not nicely organized. Perhaps it is time we start a special Ports namespace that would allow us to collate and list in one place all the user submitted wisdom and important instructions? -- Vlad K.