Mailing-List: contact dev-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@geronimo.apache.org
Received-SPF: neutral (athena.apache.org: local policy)
Message-ID: <489B635F.4000801@apache.org>
Date: Thu, 07 Aug 2008 17:04:31 -0400
From: Donald Woods <dwoods@apache.org>
User-Agent: Thunderbird 2.0.0.16 (Macintosh/20080707)
MIME-Version: 1.0
To: dev@geronimo.apache.org
Subject: Re: Documentation of new 2.2 features in current wiki?
References: <C1CEB00D-A052-4000-AD79-5E32F59FCD04@yahoo.com>
	 <5eb405c70807291406l64a08024w439ff11ad8f2e12c@mail.gmail.com>
	 <489710C3.4040102@apache.org> <489B0E87.8080000@earthlink.net>
 <5eb405c70808070843m48bb43fmc22617d260840229@mail.gmail.com>
In-Reply-To: <5eb405c70808070843m48bb43fmc22617d260840229@mail.gmail.com>
Content-Type: multipart/signed; protocol="application/x-pkcs7-signature";
 micalg=sha1; boundary="------------ms080607090909010304000406"

This is a cryptographically signed message in MIME format.

--------------ms080607090909010304000406
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

Agree.


-Donald


Jarek Gawor wrote:
> IMHO, the 2.2 space must be seeded from the 2.1 space. The question is
> just when to do it. That's why I suggested creating 2.2 content under
> some temporary space. Once we have the actual 2.2 space setup (from
> 2.1 content) then we can move these new pages into 2.2 space. It will
> be a lot easier to move just a few pages of the new content then merge
> lots of pages of 2.1 content into 2.2 space.
> 
> Jarek
> 
> On Thu, Aug 7, 2008 at 11:02 AM, Joe Bohn <joe.bohn@earthlink.net> wrote:
>> I agree in principle with creating a new location for 2.2 features to be
>> documented.  My only concern was that we are consistent so that the
>> documentation will be easy for users to find and easy to integrate when we
>> eventually do a mass merge from 2.1 to 2.2.
>>
>> So, I created a new space for 2.2 documentation to provide a consistent
>> structure and to capture the enthusiasm to document 2.2 changes.  I seeded
>> it with a top level structure that matches our 2.1 doc but no actual
>> content.  You can find it here:
>> http://cwiki.apache.org/GMOxDOC22/documentation.html
>>
>> I suggest that we create new content for 2.2 under this page for now:
>> http://cwiki.apache.org/GMOxDOC22/what-changed-in-22.html
>>  .... I chose the current name to match what we had in 2.1.
>>
>> If a particular change has broad implications for documentation that is
>> already available in 2.1, we can copy current 2.1 content into 2.2 and
>> modify it accordingly.
>>
>> As David pointed out earlier, we do not have the ability to automatically
>> merge the 2.1 content into the 2.2 content at a later time using this
>> approach.  Any merge will be a manual effort.  The only alternative I am
>> aware of would be to seed the new 2.2 space with the complete current 2.1
>> content.  However, that brings about some maintenance issues of keeping
>> things in sync and doesn't encourage 2.2 updates.  When we last discussed
>> this for 2.1 we decided to start with the empty space and so I took the same
>> approach for this release.
>>
>> I hope this provides something that will serve as a good place for the 2.2
>> content for now.  If we decide later that we should have started with a
>> complete copy of 2.1 we can always create a copy and merge the new 2.2
>> documents back into the 2.1 copy.  However, for now this at least provides a
>> place we can use and it is obvious to our users where they can find 2.2
>> documentation.
>>
>> Joe
>>
>>
>> Donald Woods wrote:
>>> Agree.  We could just create a "New Features in 2.2" page and people can
>>> create child pages to it for their new features as they are integrated into
>>> trunk....
>>>
>>>
>>> -Donald
>>>
>>>
>>> Jarek Gawor wrote:
>>>> I think it would be nicer to create pages with 2.2 specific content
>>>> somewhere under http://cwiki.apache.org/GMOxDEV/index.html for now.
>>>> Once we have 2.2 documentation space setup we can move the pages
>>>> around. Or at least I don't think we should mix 2.2 content with 2.1
>>>> content.
>>>>
>>>> Jarek
>>>>
>>>> On Tue, Jul 29, 2008 at 1:52 PM, David Jencks <david_jencks@yahoo.com>
>>>> wrote:
>>>>> I've been playing around with openid and jaspi and would like to write
>>>>> up
>>>>> some documentation before I forget how it all works :-)
>>>>>
>>>>> I don't think we have enough people interested in documentation to
>>>>> pursue
>>>>> anything but the easiest-to-write path in documentation.  In particular
>>>>> I
>>>>> think more than one active copy of the docs is asking for disaster.
>>>>>
>>>>> I'd like to suggest that feature documentation should generally start
>>>>> with a
>>>>> "starting with version xxx" comment.  So, I'd put the openid/jaspi
>>>>> documentation in the current (2.1) wiki with a "starting with 2.2"
>>>>> notice.
>>>>>  Obviously there's the problem that the wiki has the 2.1 version in its
>>>>> name. I don't know if a wiki can have its name changed but don't regard
>>>>> this
>>>>> as critical.
>>>>>
>>>>> I'm going to start doing this pending comments and better ideas.  At the
>>>>> rate I write I don't think I'll be causing significant damage before we
>>>>> have
>>>>> time for a full discussion :-)
>>>>>
>>>>> thanks
>>>>> david jencks
>>>>>
>>>>>
>>
> 

--------------ms080607090909010304000406
Content-Type: application/x-pkcs7-signature; name="smime.p7s"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="smime.p7s"
Content-Description: S/MIME Cryptographic Signature

MIAGCSqGSIb3DQEHAqCAMIACAQExCzAJBgUrDgMCGgUAMIAGCSqGSIb3DQEHAQAAoIIJbTCC
AxEwggJ6oAMCAQICEGE7sdOcvnyCHwhd2kbEvQ8wDQYJKoZIhvcNAQEFBQAwYjELMAkGA1UE
BhMCWkExJTAjBgNVBAoTHFRoYXd0ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4xLDAqBgNVBAMT
I1RoYXd0ZSBQZXJzb25hbCBGcmVlbWFpbCBJc3N1aW5nIENBMB4XDTA4MDQwMjE5MjcwOVoX
DTA5MDQwMjE5MjcwOVowZTEfMB0GA1UEAxMWVGhhd3RlIEZyZWVtYWlsIE1lbWJlcjEgMB4G
CSqGSIb3DQEJARYRZHJ3X3dlYkB5YWhvby5jb20xIDAeBgkqhkiG9w0BCQEWEWR3b29kc0Bh
cGFjaGUub3JnMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlylHzveM+GK2U2Ib
+9wzj8Ga4z4zK/wmMGbRmJ4IM9W4HBGntekfCQfwkb0K/qD8QZcQY4HfyfxIkIA+TaYy5/nL
1wWvH73Oc1HMT7Fyc7Vfkewpi1KZoxLzAdr358uAi5TEYxOoUvCxLoI+BpM1655EDyRRlD8e
dK3zemHv+gRoWkb11QmfFt6putMBi0VZZ3k2rJZRDXQDjMGOu/GPR1XcV+ah43Z/+vnPWMd+
NSqV9IUC7UWkL5kwhGpWOtgZg0tabr2xj79y13bG6fDQjwRKgSlN98wZjMQLx4MZPtn3lT1C
zCOxsqjr86MGePVk2QXNvbCkxun6EHezeKtA/wIDAQABo0EwPzAvBgNVHREEKDAmgRFkcndf
d2ViQHlhaG9vLmNvbYERZHdvb2RzQGFwYWNoZS5vcmcwDAYDVR0TAQH/BAIwADANBgkqhkiG
9w0BAQUFAAOBgQAitedgxXImBqxgW9UftLIVMaIzfKgnue/Q4GvPS0J6ucqyGB4l5f50aKEB
kuLfajXpC/ZrScinLNFi8ZvMw6KCUaiWjAwupl5KiF7cWh93kNFihD2SM+M8+hFf9kVyGMxs
49FAn3yoP9QVCQtq4C1sixTfayi4rFRvRMlPRcYqdjCCAxEwggJ6oAMCAQICEGE7sdOcvnyC
Hwhd2kbEvQ8wDQYJKoZIhvcNAQEFBQAwYjELMAkGA1UEBhMCWkExJTAjBgNVBAoTHFRoYXd0
ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4xLDAqBgNVBAMTI1RoYXd0ZSBQZXJzb25hbCBGcmVl
bWFpbCBJc3N1aW5nIENBMB4XDTA4MDQwMjE5MjcwOVoXDTA5MDQwMjE5MjcwOVowZTEfMB0G
A1UEAxMWVGhhd3RlIEZyZWVtYWlsIE1lbWJlcjEgMB4GCSqGSIb3DQEJARYRZHJ3X3dlYkB5
YWhvby5jb20xIDAeBgkqhkiG9w0BCQEWEWR3b29kc0BhcGFjaGUub3JnMIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlylHzveM+GK2U2Ib+9wzj8Ga4z4zK/wmMGbRmJ4IM9W4
HBGntekfCQfwkb0K/qD8QZcQY4HfyfxIkIA+TaYy5/nL1wWvH73Oc1HMT7Fyc7Vfkewpi1KZ
oxLzAdr358uAi5TEYxOoUvCxLoI+BpM1655EDyRRlD8edK3zemHv+gRoWkb11QmfFt6putMB
i0VZZ3k2rJZRDXQDjMGOu/GPR1XcV+ah43Z/+vnPWMd+NSqV9IUC7UWkL5kwhGpWOtgZg0ta
br2xj79y13bG6fDQjwRKgSlN98wZjMQLx4MZPtn3lT1CzCOxsqjr86MGePVk2QXNvbCkxun6
EHezeKtA/wIDAQABo0EwPzAvBgNVHREEKDAmgRFkcndfd2ViQHlhaG9vLmNvbYERZHdvb2Rz
QGFwYWNoZS5vcmcwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQUFAAOBgQAitedgxXImBqxg
W9UftLIVMaIzfKgnue/Q4GvPS0J6ucqyGB4l5f50aKEBkuLfajXpC/ZrScinLNFi8ZvMw6KC
UaiWjAwupl5KiF7cWh93kNFihD2SM+M8+hFf9kVyGMxs49FAn3yoP9QVCQtq4C1sixTfayi4
rFRvRMlPRcYqdjCCAz8wggKooAMCAQICAQ0wDQYJKoZIhvcNAQEFBQAwgdExCzAJBgNVBAYT
AlpBMRUwEwYDVQQIEwxXZXN0ZXJuIENhcGUxEjAQBgNVBAcTCUNhcGUgVG93bjEaMBgGA1UE
ChMRVGhhd3RlIENvbnN1bHRpbmcxKDAmBgNVBAsTH0NlcnRpZmljYXRpb24gU2VydmljZXMg
RGl2aXNpb24xJDAiBgNVBAMTG1RoYXd0ZSBQZXJzb25hbCBGcmVlbWFpbCBDQTErMCkGCSqG
SIb3DQEJARYccGVyc29uYWwtZnJlZW1haWxAdGhhd3RlLmNvbTAeFw0wMzA3MTcwMDAwMDBa
Fw0xMzA3MTYyMzU5NTlaMGIxCzAJBgNVBAYTAlpBMSUwIwYDVQQKExxUaGF3dGUgQ29uc3Vs
dGluZyAoUHR5KSBMdGQuMSwwKgYDVQQDEyNUaGF3dGUgUGVyc29uYWwgRnJlZW1haWwgSXNz
dWluZyBDQTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAxKY8VXNV+065yplaHmjAdQRw
nd/p/6Me7L3N9VvyGna9fww6YfK/Uc4B1OVQCjDXAmNaLIkVcI7dyfArhVqqP3FWy688Cwfn
8R+RNiQqE88r1fOCdz0Dviv+uxg+B79AgAJk16emu59l0cUqVIUPSAR/p7bRPGEEQB5kGXJg
t/sCAwEAAaOBlDCBkTASBgNVHRMBAf8ECDAGAQH/AgEAMEMGA1UdHwQ8MDowOKA2oDSGMmh0
dHA6Ly9jcmwudGhhd3RlLmNvbS9UaGF3dGVQZXJzb25hbEZyZWVtYWlsQ0EuY3JsMAsGA1Ud
DwQEAwIBBjApBgNVHREEIjAgpB4wHDEaMBgGA1UEAxMRUHJpdmF0ZUxhYmVsMi0xMzgwDQYJ
KoZIhvcNAQEFBQADgYEASIzRUIPqCy7MDaNmrGcPf6+svsIXoUOWlJ1/TCG4+DYfqi2fNi/A
9BxQIJNwPP2t4WFiw9k6GX6EsZkbAMUaC4J0niVQlGLH2ydxVyWN3amcOY6MIE9lX5Xa9/eH
1sYITq726jTlEBpbNU1341YheILcIRk13iSx0x1G/11fZU8xggNkMIIDYAIBATB2MGIxCzAJ
BgNVBAYTAlpBMSUwIwYDVQQKExxUaGF3dGUgQ29uc3VsdGluZyAoUHR5KSBMdGQuMSwwKgYD
VQQDEyNUaGF3dGUgUGVyc29uYWwgRnJlZW1haWwgSXNzdWluZyBDQQIQYTux05y+fIIfCF3a
RsS9DzAJBgUrDgMCGgUAoIIBwzAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3
DQEJBTEPFw0wODA4MDcyMTA0MzFaMCMGCSqGSIb3DQEJBDEWBBTUenUDr2K+aTLQJ6Jt6j/r
niYckjBSBgkqhkiG9w0BCQ8xRTBDMAoGCCqGSIb3DQMHMA4GCCqGSIb3DQMCAgIAgDANBggq
hkiG9w0DAgIBQDAHBgUrDgMCBzANBggqhkiG9w0DAgIBKDCBhQYJKwYBBAGCNxAEMXgwdjBi
MQswCQYDVQQGEwJaQTElMCMGA1UEChMcVGhhd3RlIENvbnN1bHRpbmcgKFB0eSkgTHRkLjEs
MCoGA1UEAxMjVGhhd3RlIFBlcnNvbmFsIEZyZWVtYWlsIElzc3VpbmcgQ0ECEGE7sdOcvnyC
Hwhd2kbEvQ8wgYcGCyqGSIb3DQEJEAILMXigdjBiMQswCQYDVQQGEwJaQTElMCMGA1UEChMc
VGhhd3RlIENvbnN1bHRpbmcgKFB0eSkgTHRkLjEsMCoGA1UEAxMjVGhhd3RlIFBlcnNvbmFs
IEZyZWVtYWlsIElzc3VpbmcgQ0ECEGE7sdOcvnyCHwhd2kbEvQ8wDQYJKoZIhvcNAQEBBQAE
ggEAVfWWNPhRXHdD8gxtOQ7Gfvo4r6QG43rgnfWIVvsTsbvEmIXS0Njz+q4v5peeuFvvq3mC
TLooLKtLf0gV1jssUdwm1dRaPmJ3oJmJwD6em33i7UScH0vbVAeUzRvNZNZl63694ClZYzd/
LCuSGplN9NIFeYd7tcdsamjgegkXbUg0BXxDDJjnCUXnzJJOnPeh5qvzLSTHV9oMXzT30X6v
JBuUtinKERcw6S8SHJmixMB9qf7M07HDeS0Gb0+Bot6M+kroeZ+sDT3ChMPJkZNo5efinUVT
qbQBLIYhNVZ4fBCx8xEHo3d8wZyCbSRKhnT5EoOngcTOm7dPjN3RMcjorAAAAAAAAA==
--------------ms080607090909010304000406--