From kato-spec-return-208-apmail-incubator-kato-spec-archive=incubator.apache.org@incubator.apache.org Wed Jul 15 08:45:44 2009 Return-Path: Delivered-To: apmail-incubator-kato-spec-archive@minotaur.apache.org Received: (qmail 85140 invoked from network); 15 Jul 2009 08:45:44 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 15 Jul 2009 08:45:44 -0000 Received: (qmail 77140 invoked by uid 500); 15 Jul 2009 08:45:53 -0000 Delivered-To: apmail-incubator-kato-spec-archive@incubator.apache.org Received: (qmail 77106 invoked by uid 500); 15 Jul 2009 08:45:53 -0000 Mailing-List: contact kato-spec-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: kato-spec@incubator.apache.org Delivered-To: mailing list kato-spec@incubator.apache.org Received: (qmail 77096 invoked by uid 99); 15 Jul 2009 08:45:53 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 15 Jul 2009 08:45:53 +0000 X-ASF-Spam-Status: No, hits=-4.0 required=10.0 tests=RCVD_IN_DNSWL_MED,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: local policy) Received: from [192.55.52.93] (HELO mga11.intel.com) (192.55.52.93) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 15 Jul 2009 08:45:42 +0000 Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga102.fm.intel.com with ESMTP; 15 Jul 2009 01:36:38 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.42,403,1243839600"; d="scan'208";a="474992301" Received: from irsmsx601.ger.corp.intel.com ([163.33.7.164]) by fmsmga002.fm.intel.com with ESMTP; 15 Jul 2009 01:38:41 -0700 Received: from irsmsx501.ger.corp.intel.com (163.33.7.70) by irsmsx601.ger.corp.intel.com (163.33.7.164) with Microsoft SMTP Server (TLS) id 8.1.358.0; Wed, 15 Jul 2009 09:44:28 +0100 Received: from irsmsx504.ger.corp.intel.com ([163.33.3.240]) by irsmsx501.ger.corp.intel.com ([163.33.7.70]) with mapi; Wed, 15 Jul 2009 09:44:28 +0100 From: "Bobrovsky, Konstantin S" To: "kato-spec@incubator.apache.org" Date: Wed, 15 Jul 2009 09:44:25 +0100 Subject: RE: JSR 326 EDR Specification document first drop and structure question Thread-Topic: JSR 326 EDR Specification document first drop and structure question Thread-Index: AcoC3tok0u1B2yMxRje1Gpdo1tEUWACSWo4g Message-ID: References: In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: acceptlanguage: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Virus-Checked: Checked by ClamAV on apache.org I can not access this document, unfortunately. The site requires login/pass= word which I don't have and don't know how to obtain. Thanks, Konst =20 Intel Novosibirsk Closed Joint Stock Company Intel A/O Registered legal address: Krylatsky Hills Business Park,=20 17 Krylatskaya Str., Bldg 4, Moscow 121614,=20 Russian Federation =20 -----Original Message----- From: Steve Poole [mailto:spoole167@googlemail.com]=20 Sent: Sunday, July 12, 2009 5:52 PM To: kato-spec@incubator.apache.org Subject: JSR 326 EDR Specification document first drop and structure questi= on I've now got a trial process going which results in a pdf of the API javadoc + a cover sheet. Its available here http://hudson.zones.apache.org/hudson/view/Kato/job/org.apache.kato/org.apa= che.kato$kato.api/ws/target/site/spec/spec.pdf The front sheet is not pretty (not sure why there are no margins) but I'm sure its fixable How should we structure this document? Is it sufficient to have an overview , licence information and javadoc? Can anyone point to a specification document they think is a good example we could use to guide us? Cheers Steve