From owner-svn-ports-head@FreeBSD.ORG Sat Aug 18 21:59:51 2012 Return-Path: Delivered-To: svn-ports-head@freebsd.org Received: from mx2.freebsd.org (mx2.freebsd.org [IPv6:2001:4f8:fff6::35]) by hub.freebsd.org (Postfix) with ESMTP id BB826106564A; Sat, 18 Aug 2012 21:59:51 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from opti.dougb.net (hub.freebsd.org [IPv6:2001:4f8:fff6::36]) by mx2.freebsd.org (Postfix) with ESMTP id 4F60114E372; Sat, 18 Aug 2012 21:59:51 +0000 (UTC) Message-ID: <50301057.9090909@FreeBSD.org> Date: Sat, 18 Aug 2012 14:59:51 -0700 From: Doug Barton Organization: http://SupersetSolutions.com/ User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:14.0) Gecko/20120728 Thunderbird/14.0 MIME-Version: 1.0 To: Jason Helfman References: <201208180839.q7I8ddm2096742@svn.freebsd.org> <20120818213024.GA43512@dormouse.experts-exchange.com> In-Reply-To: <20120818213024.GA43512@dormouse.experts-exchange.com> X-Enigmail-Version: 1.4.3 OpenPGP: id=1A1ABC84 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: svn-ports-head@freebsd.org, svn-ports-all@freebsd.org, ports-committers@freebsd.org Subject: Re: svn commit: r302713 - in head/security: libotr vuxml X-BeenThere: svn-ports-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the ports tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 18 Aug 2012 21:59:51 -0000 On 08/18/2012 14:30, Jason Helfman wrote: > Thanks for the update, Doug! I did have one question though, and I know this comes up now and then. Can you please add the cited url to the reference block inside a url tag? No. The code that produces the web pages should be fixed to use the
tag that is already there to do the right thing, rather than depending on authors to add redundant information. The process of creating these vuxml entries is absurdly complex, and if we have an expectation that run of the mill developers (as opposed to those who work with this stuff on a regular basis) are going to get these done, and get them done right, it has to be simpler. Not only have I done many of these, I've even attempted to update the documentation in TPH, and apparently I'm still getting them wrong. Given that I'm actually making an effort to understand the process and get it done right, and given the overwhelming number of times that $someone follows up to vuxml entries with advice on how they should be changed, and given the number of times that certain people have followed up with wrong/bad advice, it's pretty clear that we have a process problem here. I can see 2 ways out of this mess. One would be to change the back-end code to be more forgiving as I suggested above. The preferable solution would be for someone to write a script that allows users to input the various pieces of data, and then outputs the proper XML. Something similar to http://www.freebsd.org/cgi/monthly.cgi would do nicely. It's incredibly discouraging to go through the work of creating these entries only to constantly have them be wrong. At this point I'm seriously considering just not doing them anymore, and letting the ports-security@ team handle it if they feel it's important. Doug PS, you didn't ask a question, you made a request. -- I am only one, but I am one. I cannot do everything, but I can do something. And I will not let what I cannot do interfere with what I can do. -- Edward Everett Hale, (1822 - 1909)