From owner-freebsd-doc@FreeBSD.ORG Mon Sep 19 05:02:28 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2C699106566C for ; Mon, 19 Sep 2011 05:02:28 +0000 (UTC) (envelope-from royce.williams@gmail.com) Received: from mail-iy0-f182.google.com (mail-iy0-f182.google.com [209.85.210.182]) by mx1.freebsd.org (Postfix) with ESMTP id 000478FC08 for ; Mon, 19 Sep 2011 05:02:27 +0000 (UTC) Received: by iadk27 with SMTP id k27so7698104iad.13 for ; Sun, 18 Sep 2011 22:02:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:from:date:message-id:subject:to:content-type; bh=hnXp64+CMGpXO9aFSPwgr0BDAj58qnJVEfY41vp3p+U=; b=G+C9TqKBvdAW3aCfYCIf87dOu5UGDKPaQHiMNDoLMXUwgoW9YlpUAICLAm3+F0rCHn fBushDLk92+HLuLlK/nBzJ2Ul6R3nno3KlCWgRJkcgkZw/jGmlfCrFA6kaVa+doEFXni KwfYnKBk5Ysqx68pRiuNOu64DLRzbEllGn35g= Received: by 10.42.163.195 with SMTP id d3mr499032icy.158.1316407203116; Sun, 18 Sep 2011 21:40:03 -0700 (PDT) MIME-Version: 1.0 Received: by 10.231.48.67 with HTTP; Sun, 18 Sep 2011 21:39:43 -0700 (PDT) From: Royce Williams Date: Sun, 18 Sep 2011 20:39:43 -0800 Message-ID: To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 Subject: hardware Rosetta Stone? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Sep 2011 05:02:28 -0000 The tl;dr version: Let's start documenting our implicit knowledge about hardware. It will be significant force multiplier. If we start a stub on the wiki, it could become useful relatively quickly without a lot of effort. The long version: I've followed a few list threads that end with "Go talk to Vendor X about that." Developers, vendors and hardware owners are all busy, so this can be hard. Most hardware vendors don't have someone like Intel's Jack Vogel - competent, constructive, and paying close attention to the relevant freebsd-* lists. Even if Jack misses a message, everyone else on the lists knows to say, "Hey, send that to Jack." I've also spent a lot of time painstakingly reconstructing knowledge from multiple forums in order to arrive at The Whole Truth about a specific piece of hardware. Someone knows the answer off of the top of their head, but that person is busy frying bigger fish -- and they should be. Caching the results of that work would be a high-leverage activity. I propose creating a hardware Rosetta Stone of sorts. It would be sort of a cross between the Hardware Compatibility list, parts of Jeremy Chadwick's list of known issues, some FAQs, and a list of FreeBSD folks to coordinate between vendors and the project. As a quick start, I propose a wiki page that would contain something like these tuples: * Hardware family * Name of vendor * Brief advice on how to work with that vendor. * Identifying device info (PCI/USB IDs, etc.) * Links to significant PRs. * Link to a FAQ page/section for that hardware/drivers. * Name of coordinating volunteer(s) I'd bet that there are already some de facto vendor "ambassadors" of sorts who could seed parts of the initial list pretty quickly. Benefits: * Developers (who already get peppered with questions about given hardware) only have to answer a question once, and simply link to the Rosetta Stone thereafter. * Non-developers can take their hard-won research and put it where others can reliably find it. * Newbies spend less time chasing their tails and FAQing the lists. * Vendors get a consistent voice from, and more deliberately connect with, the FreeBSD community. * Developers who want to tackle a hardware family can easily survey the state thereof. * Vendors who are hard to connect with might be swayed by a large list of "this vendor won't work with us, but hey, their competitor is totally helpful" data points. * People could rotate through ambassadorship, to spread knowledge and prevent burnout. * Everyone gets to spend more time doing what matters. If I'm reinventing a wheel, any breadcrumbs appreciated. (I got this idea from a club I'm in that has a semi-official ambassador to eBay -- which has really benefited both eBay and the club -- and also thinking about Jack, and Jeremy's list). Royce