[Standards] long specs

Winfried Tilanus winfried at tilanus.com
Tue Feb 28 07:44:42 UTC 2012


On 02/28/2012 12:02 AM, Peter Saint-Andre wrote:

Hi,

> Over the weekend I took a rough cut at splitting up XEP-0045.
> Here's what I came up with (page lengths are based on print-to-PDF
> in Firefox):
> 
> XEP-0045 = 141 pages
> 
> Architecture, Requirements, Discovery, Security = 35 pages
> 
> Occupant Use Cases = 56 pages
> 
> Administration = 68 pages
> 
> The document that most client developers would read is the one on 
> occupant use cases. Would they find 56 pages less intimidating
> than 141 pages? Probably. (And probably we could move some stuff
> out of the occupant use cases -- requesting voice, that kind of
> thing.) Would it be worth our time to split things up this way?
> Perhaps.

For me a split up like this, would have no added value. We need all
three parts, having them in one (long) document makes things for me
more easy to oversee.

Winfried



More information about the Standards mailing list