Re: [hybi] how to better document FAQ and other stuff

Takeshi Yoshino <tyoshino@google.com> Fri, 25 February 2011 04:18 UTC

Return-Path: <tyoshino@google.com>
X-Original-To: hybi@core3.amsl.com
Delivered-To: hybi@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 4F46F3A6908 for <hybi@core3.amsl.com>; Thu, 24 Feb 2011 20:18:13 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -105.683
X-Spam-Level:
X-Spam-Status: No, score=-105.683 tagged_above=-999 required=5 tests=[AWL=0.293, BAYES_00=-2.599, FM_FORGED_GMAIL=0.622, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_MED=-4, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id MnSAsN7dos8r for <hybi@core3.amsl.com>; Thu, 24 Feb 2011 20:18:12 -0800 (PST)
Received: from smtp-out.google.com (smtp-out.google.com [216.239.44.51]) by core3.amsl.com (Postfix) with ESMTP id 3090E3A6904 for <hybi@ietf.org>; Thu, 24 Feb 2011 20:18:11 -0800 (PST)
Received: from wpaz1.hot.corp.google.com (wpaz1.hot.corp.google.com [172.24.198.65]) by smtp-out.google.com with ESMTP id p1P4J2PS031883 for <hybi@ietf.org>; Thu, 24 Feb 2011 20:19:02 -0800
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=google.com; s=beta; t=1298607542; bh=T5DjUNPzyEB00f/XAUuATvfzsYE=; h=MIME-Version:In-Reply-To:References:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=LhM3WDwch2v4YaGWpwaeVGlXtk9v+5Y0KV17iqT8fbHv5dtPAfaUuJrj+KCXSNJvK Otk4hkZ3YD8uJvSeLeCpw==
Received: from iyf40 (iyf40.prod.google.com [10.241.50.104]) by wpaz1.hot.corp.google.com with ESMTP id p1P4J1e1023573 (version=TLSv1/SSLv3 cipher=RC4-SHA bits=128 verify=NOT) for <hybi@ietf.org>; Thu, 24 Feb 2011 20:19:01 -0800
Received: by iyf40 with SMTP id 40so681153iyf.30 for <hybi@ietf.org>; Thu, 24 Feb 2011 20:19:01 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=beta; h=domainkey-signature:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc:content-type; bh=tynkxCL87sX9djORYvSnTrmmbVdL+Iq7ufQ8q5K6t1w=; b=tK7ZiO/5sC+8LDGvfP+4e0ft1NAUqyFZnl2oAzOjis7i3IASj4FLIitTc1QpNE0nGT J/VaubBuNMqZAIosPlJg==
DomainKey-Signature: a=rsa-sha1; c=nofws; d=google.com; s=beta; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; b=Qewc5cQmbV9FzOvwV9lID3ORCYwmXZwWCiGLSyBUWxhlpQGx+TG7C+te6inFjGwrqW UEltvK0tXKZrRb/HJyZQ==
Received: by 10.42.162.65 with SMTP id w1mr238113icx.298.1298607537467; Thu, 24 Feb 2011 20:18:57 -0800 (PST)
MIME-Version: 1.0
Received: by 10.231.17.201 with HTTP; Thu, 24 Feb 2011 20:18:37 -0800 (PST)
In-Reply-To: <4D66CD88.2090106@callenish.com>
References: <4D6678C2.6000400@ericsson.com> <4D66CD88.2090106@callenish.com>
From: Takeshi Yoshino <tyoshino@google.com>
Date: Fri, 25 Feb 2011 13:18:37 +0900
Message-ID: <AANLkTi=fRFha__zeYaWJXDD2PkHtsebvvotXZzQTv3iY@mail.gmail.com>
To: Salvatore Loreto <salvatore.loreto@ericsson.com>
Content-Type: multipart/alternative; boundary="90e6ba6e8b74f9308b049d13a0f2"
X-System-Of-Record: true
Cc: "hybi@ietf.org" <hybi@ietf.org>
Subject: Re: [hybi] how to better document FAQ and other stuff
X-BeenThere: hybi@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: Server-Initiated HTTP <hybi.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/hybi>, <mailto:hybi-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/hybi>
List-Post: <mailto:hybi@ietf.org>
List-Help: <mailto:hybi-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/hybi>, <mailto:hybi-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 25 Feb 2011 04:18:13 -0000

I've copied my note to the wiki.

Takeshi


On Fri, Feb 25, 2011 at 06:28, Bruce Atherton <bruce@callenish.com> wrote:

> I've added a section on how the decision for masking was achieved.
> Hopefully it will clarify some things being discussed. I've tried to
> represent the majority of opinions expressed during the debates several
> months ago, but if someone feels I've misrepresented a position or left out
> something important, please edit it to make it more representative of the
> history.
>
>
> On 24/02/2011 7:26 AM, Salvatore Loreto wrote:
>
>> (as co-chair)
>>
>> Hi there,
>>
>> after reading the last two days mails,
>> I think that it would be good have a FAQ where newcomers can find some
>> information,
>> to understand a little better the rational behind some choice and other
>> stuff,
>> without be forced to go through all the HyBi mail archives... (more the
>> 6000mails)
>> or put on the editor and wg main contributors shoulders the responsibility
>> to provide the information.
>>
>> I have created a wiki page, within the IETF website, where we can start to
>> collect info:
>> http://trac.tools.ietf.org/wg/hybi/trac/wiki/FAQ
>>
>>
>> in order to update the page you need to login,
>> if you do not have a login/pw you can get one from here:
>> http://trac.tools.ietf.org/tools/loginmgr/newlogin
>>
>> anyone can contribute to build the FAQ.
>> I have already received mails from people interested to contribute,
>> so people interested/eager to contribute
>> can start to contribute and just notify the HyBi ml when they do some
>> change.
>>
>>
>> About the possibility to also document more information within a draft,
>> I don't think draft-ietf-hybi-thewebsocketprotocol is the right document
>> for that;
>> instead we can use the
>> http://tools.ietf.org/html/draft-ietf-hybi-design-space
>> as I have been suggested by Stefano Salsano
>>
>>
>> cheers
>> /Sal
>>
>>
>>
> _______________________________________________
> hybi mailing list
> hybi@ietf.org
> https://www.ietf.org/mailman/listinfo/hybi
>