[ogpx] why we might want to move things into different docs

Infinity Linden <infinity@lindenlab.com> Thu, 03 September 2009 16:39 UTC

Return-Path: <infinity@lindenlab.com>
X-Original-To: ogpx@core3.amsl.com
Delivered-To: ogpx@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 8BABB3A6D0C for <ogpx@core3.amsl.com>; Thu, 3 Sep 2009 09:39:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.869
X-Spam-Level:
X-Spam-Status: No, score=-1.869 tagged_above=-999 required=5 tests=[AWL=0.108, BAYES_00=-2.599, FM_FORGED_GMAIL=0.622]
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 jVmIoHUmjSWP for <ogpx@core3.amsl.com>; Thu, 3 Sep 2009 09:39:07 -0700 (PDT)
Received: from mail-vw0-f177.google.com (mail-vw0-f177.google.com [209.85.212.177]) by core3.amsl.com (Postfix) with ESMTP id AC52A3A68F6 for <ogpx@ietf.org>; Thu, 3 Sep 2009 09:39:07 -0700 (PDT)
Received: by vws7 with SMTP id 7so83548vws.29 for <ogpx@ietf.org>; Thu, 03 Sep 2009 09:37:21 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.150.243.15 with SMTP id q15mr15362263ybh.335.1251995840745; Thu, 03 Sep 2009 09:37:20 -0700 (PDT)
Date: Thu, 3 Sep 2009 09:37:20 -0700
Message-ID: <3a880e2c0909030937k9a63f32y4ea41ab4050eb304@mail.gmail.com>
From: Infinity Linden <infinity@lindenlab.com>
To: ogpx@ietf.org
Content-Type: text/plain; charset=ISO-8859-1
Subject: [ogpx] why we might want to move things into different docs
X-BeenThere: ogpx@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: Virtual Worlds and the Open Grid Protocol <ogpx.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/ogpx>, <mailto:ogpx-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ogpx>
List-Post: <mailto:ogpx@ietf.org>
List-Help: <mailto:ogpx-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ogpx>, <mailto:ogpx-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 03 Sep 2009 16:39:09 -0000

so it seems to me we have a lot of freedom about what topics get put
in which docs. now that we have rough consensus on the scope of the
work, it _should_ be relatively easy to come up with a list of "high
level topics" including (but not limited to) LLSD, user
authentication, teleporting between regions, moving your avatars,
etc., etc.

when we have this list, we can then decide which topics get covered by
which document. from what i hear from experienced IETF peeps is that
we should make our best guess about what topics go into which
document, but if we later discover we should of put in an extra topic
or two or that we have to move topics between docs, it's not the end
of the world, and as long as there's general agreement on the list,
it's not a difficult thing to do.

so i thought it was useful just to mention some criteria for why
certain topics should go in certain documents...

please feel free to ignore or comment at your leisure. i'm just kinda
curious what people think.

* contextual closeness - topics that are similar should go in the same
document. for example, you would expect discussions about how to send
commands to move an avatar around on the ground to be in the same doc
as commands to get the avatar to start flying.

* schedule - are there things we all agree we want to work on sooner
rather than later? i would argue that we should have radical agreement
on the intro, abstract type system and foundations docs before
thinking we can finish other docs.

* extension - are there things we know we intentionally want to
extend, or make it easier for other people to extend? (like the asset
or avatar formats or transport bindings?) maybe it makes sense to have
documents describing avatar formats be in a different doc from asset
formats or entity descriptors because people may want to extend each
of these things independently.

any other criteria for figuring out what topics go in what document?

-cheers,
-meadhbh