You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tamaya.apache.org by Anatole Tresch <at...@gmail.com> on 2014/11/27 21:58:55 UTC

Tamaya Project Discussion

Dear all

I would suggest to try to ramp up the discussions (and along with it
implementations) in the following way:

*1. Use Cases and Requirements*

*2. Core Concepts*
*2.1 Environment, Stage*
*2.2 PropertyProvider, Configuration and composite design*
*2.3 Change Listeners and Mutability*
*2.4 Extension Points*
*2.5 Additional Services (default provider implementations, combining and
filtering providers)*

*3. Advanced Concepts*

*3.1 Multi-Environment-Support*
*3.2 Configuration Providers*
*3.3 Freezing, Serialization, Remoting*

*4. Modules*
*4.1 CDI/EE Integration*
*4.2 Other Java EE Support*
*4.3 JMX Management ?*
*4.4 Default Java EE Configuration (EE ready solution working OOTB)*
*4.3 ???*

*5. Extensions*
*5.1 Configuration Client/Server...?*
*5.2 Configuration Server Setup UIs?*

I propose to setup an asciidoc document for each part. That way we can
compose a comprehensive design documentation easily step by step and also
keep good focus on the aspects. As a starting I will try to update/split
the existing document here (mirrored):

https://github.com/apache/incubator-tamaya/blob/master/api/src/main/asciidoc/JavaConfigSpecification.adoc

Without bigger objections I will try to setup the document parts
accordingly.

Additionally I would propose to move them from
 *api/src/main/asciidoc  *
up to
* api/doc/*

So they are more easily accessible.

Do you think this is a good way to start?

Best,
Anatole



-- 
*Anatole Tresch*
Java Engineer & Architect, JSR Spec Lead
Glärnischweg 10
CH - 8620 Wetzikon

*Switzerland, Europe Zurich, GMT+1*
*Twitter:  @atsticks*
*Blogs: **http://javaremarkables.blogspot.ch/
<http://javaremarkables.blogspot.ch/>*

*Google: atsticksMobile  +41-76 344 62 79*

Re: Tamaya Project Discussion

Posted by Romain Manni-Bucau <rm...@gmail.com>.
+1 + IMO system data should surely be an extension but not part of the
core. In particular since we can hope from a config solution to work
in a cluster *too* so it wouldn't mean anything anymore.


Romain Manni-Bucau
@rmannibucau
http://www.tomitribe.com
http://rmannibucau.wordpress.com
https://github.com/rmannibucau


2014-11-29 21:27 GMT+01:00 Gerhard Petracek <ge...@gmail.com>:
> before we continue - please have a look at the suggestion at [1].
>
> regards,
> gerhard
>
> [1] http://s.apache.org/JpU
>
>
>
> 2014-11-29 21:08 GMT+01:00 Otávio Gonçalves de Santana <
> otaviopolianasantana@gmail.com>:
>
>> If we added the *system configurations* like number of processors, System
>> Operation, WDYT?
>>
>> Obs: I am consideration the next CDI, CDI 2.0, can run in Java SE, so it
>> will be useful.
>>
>>
>> @System("processor")
>>
>> private Integer processors;
>>
>>
>>
>>
>> On Thu, Nov 27, 2014 at 6:58 PM, Anatole Tresch <at...@gmail.com>
>> wrote:
>>
>> > Dear all
>> >
>> > I would suggest to try to ramp up the discussions (and along with it
>> > implementations) in the following way:
>> >
>> > *1. Use Cases and Requirements*
>> >
>> > *2. Core Concepts*
>> > *2.1 Environment, Stage*
>> > *2.2 PropertyProvider, Configuration and composite design*
>> > *2.3 Change Listeners and Mutability*
>> > *2.4 Extension Points*
>> > *2.5 Additional Services (default provider implementations, combining and
>> > filtering providers)*
>> >
>> > *3. Advanced Concepts*
>> >
>> > *3.1 Multi-Environment-Support*
>> > *3.2 Configuration Providers*
>> > *3.3 Freezing, Serialization, Remoting*
>> >
>> > *4. Modules*
>> > *4.1 CDI/EE Integration*
>> > *4.2 Other Java EE Support*
>> > *4.3 JMX Management ?*
>> > *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
>> > *4.3 ???*
>> >
>> > *5. Extensions*
>> > *5.1 Configuration Client/Server...?*
>> > *5.2 Configuration Server Setup UIs?*
>> >
>> > I propose to setup an asciidoc document for each part. That way we can
>> > compose a comprehensive design documentation easily step by step and also
>> > keep good focus on the aspects. As a starting I will try to update/split
>> > the existing document here (mirrored):
>> >
>> >
>> >
>> https://github.com/apache/incubator-tamaya/blob/master/api/src/main/asciidoc/JavaConfigSpecification.adoc
>> >
>> > Without bigger objections I will try to setup the document parts
>> > accordingly.
>> >
>> > Additionally I would propose to move them from
>> >  *api/src/main/asciidoc  *
>> > up to
>> > * api/doc/*
>> >
>> > So they are more easily accessible.
>> >
>> > Do you think this is a good way to start?
>> >
>> > Best,
>> > Anatole
>> >
>> >
>> >
>> > --
>> > *Anatole Tresch*
>> > Java Engineer & Architect, JSR Spec Lead
>> > Glärnischweg 10
>> > CH - 8620 Wetzikon
>> >
>> > *Switzerland, Europe Zurich, GMT+1*
>> > *Twitter:  @atsticks*
>> > *Blogs: **http://javaremarkables.blogspot.ch/
>> > <http://javaremarkables.blogspot.ch/>*
>> >
>> > *Google: atsticksMobile  +41-76 344 62 79*
>> >
>>
>>
>>
>> --
>> Otávio Gonçalves de Santana
>>
>> blog:     http://otaviosantana.blogspot.com.br/
>> twitter: http://twitter.com/otaviojava
>> site:     *http://about.me/otaviojava <http://about.me/otaviojava>*
>> 55 (11) 98255-3513
>>

Re: Tamaya Project Discussion

Posted by Gerhard Petracek <ge...@gmail.com>.
before we continue - please have a look at the suggestion at [1].

regards,
gerhard

[1] http://s.apache.org/JpU



2014-11-29 21:08 GMT+01:00 Otávio Gonçalves de Santana <
otaviopolianasantana@gmail.com>:

> If we added the *system configurations* like number of processors, System
> Operation, WDYT?
>
> Obs: I am consideration the next CDI, CDI 2.0, can run in Java SE, so it
> will be useful.
>
>
> @System("processor")
>
> private Integer processors;
>
>
>
>
> On Thu, Nov 27, 2014 at 6:58 PM, Anatole Tresch <at...@gmail.com>
> wrote:
>
> > Dear all
> >
> > I would suggest to try to ramp up the discussions (and along with it
> > implementations) in the following way:
> >
> > *1. Use Cases and Requirements*
> >
> > *2. Core Concepts*
> > *2.1 Environment, Stage*
> > *2.2 PropertyProvider, Configuration and composite design*
> > *2.3 Change Listeners and Mutability*
> > *2.4 Extension Points*
> > *2.5 Additional Services (default provider implementations, combining and
> > filtering providers)*
> >
> > *3. Advanced Concepts*
> >
> > *3.1 Multi-Environment-Support*
> > *3.2 Configuration Providers*
> > *3.3 Freezing, Serialization, Remoting*
> >
> > *4. Modules*
> > *4.1 CDI/EE Integration*
> > *4.2 Other Java EE Support*
> > *4.3 JMX Management ?*
> > *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
> > *4.3 ???*
> >
> > *5. Extensions*
> > *5.1 Configuration Client/Server...?*
> > *5.2 Configuration Server Setup UIs?*
> >
> > I propose to setup an asciidoc document for each part. That way we can
> > compose a comprehensive design documentation easily step by step and also
> > keep good focus on the aspects. As a starting I will try to update/split
> > the existing document here (mirrored):
> >
> >
> >
> https://github.com/apache/incubator-tamaya/blob/master/api/src/main/asciidoc/JavaConfigSpecification.adoc
> >
> > Without bigger objections I will try to setup the document parts
> > accordingly.
> >
> > Additionally I would propose to move them from
> >  *api/src/main/asciidoc  *
> > up to
> > * api/doc/*
> >
> > So they are more easily accessible.
> >
> > Do you think this is a good way to start?
> >
> > Best,
> > Anatole
> >
> >
> >
> > --
> > *Anatole Tresch*
> > Java Engineer & Architect, JSR Spec Lead
> > Glärnischweg 10
> > CH - 8620 Wetzikon
> >
> > *Switzerland, Europe Zurich, GMT+1*
> > *Twitter:  @atsticks*
> > *Blogs: **http://javaremarkables.blogspot.ch/
> > <http://javaremarkables.blogspot.ch/>*
> >
> > *Google: atsticksMobile  +41-76 344 62 79*
> >
>
>
>
> --
> Otávio Gonçalves de Santana
>
> blog:     http://otaviosantana.blogspot.com.br/
> twitter: http://twitter.com/otaviojava
> site:     *http://about.me/otaviojava <http://about.me/otaviojava>*
> 55 (11) 98255-3513
>

Re: Tamaya Project Discussion

Posted by Otávio Gonçalves de Santana <ot...@gmail.com>.
If we added the *system configurations* like number of processors, System
Operation, WDYT?

Obs: I am consideration the next CDI, CDI 2.0, can run in Java SE, so it
will be useful.


@System("processor")

private Integer processors;




On Thu, Nov 27, 2014 at 6:58 PM, Anatole Tresch <at...@gmail.com> wrote:

> Dear all
>
> I would suggest to try to ramp up the discussions (and along with it
> implementations) in the following way:
>
> *1. Use Cases and Requirements*
>
> *2. Core Concepts*
> *2.1 Environment, Stage*
> *2.2 PropertyProvider, Configuration and composite design*
> *2.3 Change Listeners and Mutability*
> *2.4 Extension Points*
> *2.5 Additional Services (default provider implementations, combining and
> filtering providers)*
>
> *3. Advanced Concepts*
>
> *3.1 Multi-Environment-Support*
> *3.2 Configuration Providers*
> *3.3 Freezing, Serialization, Remoting*
>
> *4. Modules*
> *4.1 CDI/EE Integration*
> *4.2 Other Java EE Support*
> *4.3 JMX Management ?*
> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
> *4.3 ???*
>
> *5. Extensions*
> *5.1 Configuration Client/Server...?*
> *5.2 Configuration Server Setup UIs?*
>
> I propose to setup an asciidoc document for each part. That way we can
> compose a comprehensive design documentation easily step by step and also
> keep good focus on the aspects. As a starting I will try to update/split
> the existing document here (mirrored):
>
>
> https://github.com/apache/incubator-tamaya/blob/master/api/src/main/asciidoc/JavaConfigSpecification.adoc
>
> Without bigger objections I will try to setup the document parts
> accordingly.
>
> Additionally I would propose to move them from
>  *api/src/main/asciidoc  *
> up to
> * api/doc/*
>
> So they are more easily accessible.
>
> Do you think this is a good way to start?
>
> Best,
> Anatole
>
>
>
> --
> *Anatole Tresch*
> Java Engineer & Architect, JSR Spec Lead
> Glärnischweg 10
> CH - 8620 Wetzikon
>
> *Switzerland, Europe Zurich, GMT+1*
> *Twitter:  @atsticks*
> *Blogs: **http://javaremarkables.blogspot.ch/
> <http://javaremarkables.blogspot.ch/>*
>
> *Google: atsticksMobile  +41-76 344 62 79*
>



-- 
Otávio Gonçalves de Santana

blog:     http://otaviosantana.blogspot.com.br/
twitter: http://twitter.com/otaviojava
site:     *http://about.me/otaviojava <http://about.me/otaviojava>*
55 (11) 98255-3513

Re: Tamaya Project Discussion

Posted by Anatole Tresch <at...@gmail.com>.
Good point, I would rather call it "Type Support" than data model, but
let's see...

2014-11-27 22:39 GMT+01:00 Oliver B. Fischer <o....@swe-blog.net>:

> I would like to add “Data Model” to section 2. Core Concepts.
>
> I think we should support data type conversion for configuration values to
> support scenarios like:
>
> |config.properties|:
>
> |value=12
> target=http://www.apache.org
> id=7921496a-767d-11e4-a9d3-3c15c2c77b1a
> |
>
> |Config.java|
>
> |public class Config {
>     @Configured int value; // Will be 12
>     @Configured URL target; // Will be http://www.apache.org
>     @Configured UUID id; // Will be 7921496a-767d-11e4-a9d3-3c15c2c77b1a
> }
> |
>
> wdyt?
>
> Oliver
>
> Am 27.11.14 21:58, schrieb Anatole Tresch:
>
>  Dear all
>>
>> I would suggest to try to ramp up the discussions (and along with it
>> implementations) in the following way:
>>
>> *1. Use Cases and Requirements*
>>
>> *2. Core Concepts*
>> *2.1 Environment, Stage*
>> *2.2 PropertyProvider, Configuration and composite design*
>> *2.3 Change Listeners and Mutability*
>> *2.4 Extension Points*
>> *2.5 Additional Services (default provider implementations, combining and
>> filtering providers)*
>>
>> *3. Advanced Concepts*
>>
>> *3.1 Multi-Environment-Support*
>> *3.2 Configuration Providers*
>> *3.3 Freezing, Serialization, Remoting*
>>
>> *4. Modules*
>> *4.1 CDI/EE Integration*
>> *4.2 Other Java EE Support*
>> *4.3 JMX Management ?*
>> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
>> *4.3 ???*
>>
>> *5. Extensions*
>> *5.1 Configuration Client/Server...?*
>> *5.2 Configuration Server Setup UIs?*
>>
>> I propose to setup an asciidoc document for each part. That way we can
>> compose a comprehensive design documentation easily step by step and also
>> keep good focus on the aspects. As a starting I will try to update/split
>> the existing document here (mirrored):
>>
>> https://github.com/apache/incubator-tamaya/blob/master/
>> api/src/main/asciidoc/JavaConfigSpecification.adoc
>>
>> Without bigger objections I will try to setup the document parts
>> accordingly.
>>
>> Additionally I would propose to move them from
>>   *api/src/main/asciidoc  *
>> up to
>> * api/doc/*
>>
>> So they are more easily accessible.
>>
>> Do you think this is a good way to start?
>>
>> Best,
>> Anatole
>>
>>
>>
>>  ​
>
> --
> N Oliver B. Fischer
> A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
> P +49 30 44793251
> M +49 178 7903538
> E o.b.fischer@swe-blog.net
> S oliver.b.fischer
> J oliver.b.fischer@jabber.org
> X http://xing.to/obf
>
>


-- 
*Anatole Tresch*
Java Engineer & Architect, JSR Spec Lead
Glärnischweg 10
CH - 8620 Wetzikon

*Switzerland, Europe Zurich, GMT+1*
*Twitter:  @atsticks*
*Blogs: **http://javaremarkables.blogspot.ch/
<http://javaremarkables.blogspot.ch/>*

*Google: atsticksMobile  +41-76 344 62 79*

Re: Tamaya Project Discussion

Posted by "Oliver B. Fischer" <o....@swe-blog.net>.
I would like to add “Data Model” to section 2. Core Concepts.

I think we should support data type conversion for configuration values 
to support scenarios like:

|config.properties|:

|value=12
target=http://www.apache.org
id=7921496a-767d-11e4-a9d3-3c15c2c77b1a
|

|Config.java|

|public class Config {
     @Configured int value; // Will be 12
     @Configured URL target; // Will be http://www.apache.org
     @Configured UUID id; // Will be 7921496a-767d-11e4-a9d3-3c15c2c77b1a
}
|

wdyt?

Oliver

Am 27.11.14 21:58, schrieb Anatole Tresch:

> Dear all
>
> I would suggest to try to ramp up the discussions (and along with it
> implementations) in the following way:
>
> *1. Use Cases and Requirements*
>
> *2. Core Concepts*
> *2.1 Environment, Stage*
> *2.2 PropertyProvider, Configuration and composite design*
> *2.3 Change Listeners and Mutability*
> *2.4 Extension Points*
> *2.5 Additional Services (default provider implementations, combining and
> filtering providers)*
>
> *3. Advanced Concepts*
>
> *3.1 Multi-Environment-Support*
> *3.2 Configuration Providers*
> *3.3 Freezing, Serialization, Remoting*
>
> *4. Modules*
> *4.1 CDI/EE Integration*
> *4.2 Other Java EE Support*
> *4.3 JMX Management ?*
> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
> *4.3 ???*
>
> *5. Extensions*
> *5.1 Configuration Client/Server...?*
> *5.2 Configuration Server Setup UIs?*
>
> I propose to setup an asciidoc document for each part. That way we can
> compose a comprehensive design documentation easily step by step and also
> keep good focus on the aspects. As a starting I will try to update/split
> the existing document here (mirrored):
>
> https://github.com/apache/incubator-tamaya/blob/master/api/src/main/asciidoc/JavaConfigSpecification.adoc
>
> Without bigger objections I will try to setup the document parts
> accordingly.
>
> Additionally I would propose to move them from
>   *api/src/main/asciidoc  *
> up to
> * api/doc/*
>
> So they are more easily accessible.
>
> Do you think this is a good way to start?
>
> Best,
> Anatole
>
>
>
​

-- 
N Oliver B. Fischer
A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
P +49 30 44793251
M +49 178 7903538
E o.b.fischer@swe-blog.net
S oliver.b.fischer
J oliver.b.fischer@jabber.org
X http://xing.to/obf


Re: Tamaya Project Discussion

Posted by Anatole Tresch <at...@gmail.com>.
Hi John

You mean a svn repo? Afaik apache cms works with subversion only? Do we
have such a repo setup, where is it? I would start with something similar
as Deltaspike and adapt contents to our needs...

John D. Ament <jo...@apache.org> schrieb am Fr., 28. Nov. 2014 um
04:06:

> On Thu, Nov 27, 2014 at 6:42 PM, Anatole Tresch <at...@gmail.com>
> wrote:
> > ...OK a module is not a separate repo, so for general project
> documentation
> > this may be a good ideas as well, other opinions?
>
> I would like to have a "site" module in the repo that represented the
> site and any docs we want to publish.
>
> Just to point out, the goal of the incubator is to get a project
> going, know that it can deal with the apache infra well (cut releases,
> etc), and grow a community.
>
> >
> > 2014-11-27 22:40 GMT+01:00 Oliver B. Fischer <o....@swe-blog.net>:
> >
> >> @Anatole May we should move all the docs to a separate module? So it
> would
> >> be easier to include/exclude it from a build.
> >>
> >> Oliver
> >>
> >> Am 27.11.14 21:58, schrieb Anatole Tresch:
> >>
> >>> Dear all
> >>>
> >>> I would suggest to try to ramp up the discussions (and along with it
> >>> implementations) in the following way:
> >>>
> >>> *1. Use Cases and Requirements*
> >>>
> >>> *2. Core Concepts*
> >>> *2.1 Environment, Stage*
> >>> *2.2 PropertyProvider, Configuration and composite design*
> >>> *2.3 Change Listeners and Mutability*
> >>> *2.4 Extension Points*
> >>> *2.5 Additional Services (default provider implementations, combining
> and
> >>> filtering providers)*
> >>>
> >>> *3. Advanced Concepts*
> >>>
> >>> *3.1 Multi-Environment-Support*
> >>> *3.2 Configuration Providers*
> >>> *3.3 Freezing, Serialization, Remoting*
> >>>
> >>> *4. Modules*
> >>> *4.1 CDI/EE Integration*
> >>> *4.2 Other Java EE Support*
> >>> *4.3 JMX Management ?*
> >>> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
> >>> *4.3 ???*
> >>>
> >>> *5. Extensions*
> >>> *5.1 Configuration Client/Server...?*
> >>> *5.2 Configuration Server Setup UIs?*
> >>>
> >>> I propose to setup an asciidoc document for each part. That way we can
> >>> compose a comprehensive design documentation easily step by step and
> also
> >>> keep good focus on the aspects. As a starting I will try to
> update/split
> >>> the existing document here (mirrored):
> >>>
> >>> https://github.com/apache/incubator-tamaya/blob/master/
> >>> api/src/main/asciidoc/JavaConfigSpecification.adoc
> >>>
> >>> Without bigger objections I will try to setup the document parts
> >>> accordingly.
> >>>
> >>> Additionally I would propose to move them from
> >>>   *api/src/main/asciidoc  *
> >>> up to
> >>> * api/doc/*
> >>>
> >>> So they are more easily accessible.
> >>>
> >>> Do you think this is a good way to start?
> >>>
> >>> Best,
> >>> Anatole
> >>>
> >>>
> >>>
> >>>
> >> --
> >> N Oliver B. Fischer
> >> A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
> >> P +49 30 44793251
> >> M +49 178 7903538
> >> E o.b.fischer@swe-blog.net
> >> S oliver.b.fischer
> >> J oliver.b.fischer@jabber.org
> >> X http://xing.to/obf
> >>
> >>
> >
> >
> > --
> > *Anatole Tresch*
> > Java Engineer & Architect, JSR Spec Lead
> > Glärnischweg 10
> > CH - 8620 Wetzikon
> >
> > *Switzerland, Europe Zurich, GMT+1*
> > *Twitter:  @atsticks*
> > *Blogs: **http://javaremarkables.blogspot.ch/
> > <http://javaremarkables.blogspot.ch/>*
> >
> > *Google: atsticksMobile  +41-76 344 62 79*
>

Re: Tamaya Project Discussion

Posted by "John D. Ament" <jo...@apache.org>.
On Thu, Nov 27, 2014 at 6:42 PM, Anatole Tresch <at...@gmail.com> wrote:
> ...OK a module is not a separate repo, so for general project documentation
> this may be a good ideas as well, other opinions?

I would like to have a "site" module in the repo that represented the
site and any docs we want to publish.

Just to point out, the goal of the incubator is to get a project
going, know that it can deal with the apache infra well (cut releases,
etc), and grow a community.

>
> 2014-11-27 22:40 GMT+01:00 Oliver B. Fischer <o....@swe-blog.net>:
>
>> @Anatole May we should move all the docs to a separate module? So it would
>> be easier to include/exclude it from a build.
>>
>> Oliver
>>
>> Am 27.11.14 21:58, schrieb Anatole Tresch:
>>
>>> Dear all
>>>
>>> I would suggest to try to ramp up the discussions (and along with it
>>> implementations) in the following way:
>>>
>>> *1. Use Cases and Requirements*
>>>
>>> *2. Core Concepts*
>>> *2.1 Environment, Stage*
>>> *2.2 PropertyProvider, Configuration and composite design*
>>> *2.3 Change Listeners and Mutability*
>>> *2.4 Extension Points*
>>> *2.5 Additional Services (default provider implementations, combining and
>>> filtering providers)*
>>>
>>> *3. Advanced Concepts*
>>>
>>> *3.1 Multi-Environment-Support*
>>> *3.2 Configuration Providers*
>>> *3.3 Freezing, Serialization, Remoting*
>>>
>>> *4. Modules*
>>> *4.1 CDI/EE Integration*
>>> *4.2 Other Java EE Support*
>>> *4.3 JMX Management ?*
>>> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
>>> *4.3 ???*
>>>
>>> *5. Extensions*
>>> *5.1 Configuration Client/Server...?*
>>> *5.2 Configuration Server Setup UIs?*
>>>
>>> I propose to setup an asciidoc document for each part. That way we can
>>> compose a comprehensive design documentation easily step by step and also
>>> keep good focus on the aspects. As a starting I will try to update/split
>>> the existing document here (mirrored):
>>>
>>> https://github.com/apache/incubator-tamaya/blob/master/
>>> api/src/main/asciidoc/JavaConfigSpecification.adoc
>>>
>>> Without bigger objections I will try to setup the document parts
>>> accordingly.
>>>
>>> Additionally I would propose to move them from
>>>   *api/src/main/asciidoc  *
>>> up to
>>> * api/doc/*
>>>
>>> So they are more easily accessible.
>>>
>>> Do you think this is a good way to start?
>>>
>>> Best,
>>> Anatole
>>>
>>>
>>>
>>>
>> --
>> N Oliver B. Fischer
>> A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
>> P +49 30 44793251
>> M +49 178 7903538
>> E o.b.fischer@swe-blog.net
>> S oliver.b.fischer
>> J oliver.b.fischer@jabber.org
>> X http://xing.to/obf
>>
>>
>
>
> --
> *Anatole Tresch*
> Java Engineer & Architect, JSR Spec Lead
> Glärnischweg 10
> CH - 8620 Wetzikon
>
> *Switzerland, Europe Zurich, GMT+1*
> *Twitter:  @atsticks*
> *Blogs: **http://javaremarkables.blogspot.ch/
> <http://javaremarkables.blogspot.ch/>*
>
> *Google: atsticksMobile  +41-76 344 62 79*

Re: Tamaya Project Discussion

Posted by Anatole Tresch <at...@gmail.com>.
...OK a module is not a separate repo, so for general project documentation
this may be a good ideas as well, other opinions?

2014-11-27 22:40 GMT+01:00 Oliver B. Fischer <o....@swe-blog.net>:

> @Anatole May we should move all the docs to a separate module? So it would
> be easier to include/exclude it from a build.
>
> Oliver
>
> Am 27.11.14 21:58, schrieb Anatole Tresch:
>
>> Dear all
>>
>> I would suggest to try to ramp up the discussions (and along with it
>> implementations) in the following way:
>>
>> *1. Use Cases and Requirements*
>>
>> *2. Core Concepts*
>> *2.1 Environment, Stage*
>> *2.2 PropertyProvider, Configuration and composite design*
>> *2.3 Change Listeners and Mutability*
>> *2.4 Extension Points*
>> *2.5 Additional Services (default provider implementations, combining and
>> filtering providers)*
>>
>> *3. Advanced Concepts*
>>
>> *3.1 Multi-Environment-Support*
>> *3.2 Configuration Providers*
>> *3.3 Freezing, Serialization, Remoting*
>>
>> *4. Modules*
>> *4.1 CDI/EE Integration*
>> *4.2 Other Java EE Support*
>> *4.3 JMX Management ?*
>> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
>> *4.3 ???*
>>
>> *5. Extensions*
>> *5.1 Configuration Client/Server...?*
>> *5.2 Configuration Server Setup UIs?*
>>
>> I propose to setup an asciidoc document for each part. That way we can
>> compose a comprehensive design documentation easily step by step and also
>> keep good focus on the aspects. As a starting I will try to update/split
>> the existing document here (mirrored):
>>
>> https://github.com/apache/incubator-tamaya/blob/master/
>> api/src/main/asciidoc/JavaConfigSpecification.adoc
>>
>> Without bigger objections I will try to setup the document parts
>> accordingly.
>>
>> Additionally I would propose to move them from
>>   *api/src/main/asciidoc  *
>> up to
>> * api/doc/*
>>
>> So they are more easily accessible.
>>
>> Do you think this is a good way to start?
>>
>> Best,
>> Anatole
>>
>>
>>
>>
> --
> N Oliver B. Fischer
> A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
> P +49 30 44793251
> M +49 178 7903538
> E o.b.fischer@swe-blog.net
> S oliver.b.fischer
> J oliver.b.fischer@jabber.org
> X http://xing.to/obf
>
>


-- 
*Anatole Tresch*
Java Engineer & Architect, JSR Spec Lead
Glärnischweg 10
CH - 8620 Wetzikon

*Switzerland, Europe Zurich, GMT+1*
*Twitter:  @atsticks*
*Blogs: **http://javaremarkables.blogspot.ch/
<http://javaremarkables.blogspot.ch/>*

*Google: atsticksMobile  +41-76 344 62 79*

Re: Tamaya Project Discussion

Posted by "Oliver B. Fischer" <o....@swe-blog.net>.
I will have a look at it. I added a profile to the POM to build the 
documentation too during a build. You can enable it via -DgenerateDocuments.

Bye,

Oliver

Am 28.11.14 07:55, schrieb Anatole Tresch:
> Hi Oli
>
> I moved things into a docs module. (Currently not linked as a module of the
> tamaya root pom so it will not build automatically. As well I separated
> existing contents into subfiles, so we can more easily edit them.
> So everybody is invited
>
> - to review the use cases file
> - add content to the requirements file
> - read and comment on the first part of the core concepts file.
>
> The ladder is as well a good starting point for a first discussion round
> about the core concepts, especially property providers, environment and
> configuration model.
>
> Cheers,
> Anatole
> Oliver B. Fischer <o....@swe-blog.net> schrieb am Do., 27. Nov. 2014
> um 22:42:
>
>> @Anatole May we should move all the docs to a separate module? So it
>> would be easier to include/exclude it from a build.
>>
>> Oliver
>>
>> Am 27.11.14 21:58, schrieb Anatole Tresch:
>>> Dear all
>>>
>>> I would suggest to try to ramp up the discussions (and along with it
>>> implementations) in the following way:
>>>
>>> *1. Use Cases and Requirements*
>>>
>>> *2. Core Concepts*
>>> *2.1 Environment, Stage*
>>> *2.2 PropertyProvider, Configuration and composite design*
>>> *2.3 Change Listeners and Mutability*
>>> *2.4 Extension Points*
>>> *2.5 Additional Services (default provider implementations, combining and
>>> filtering providers)*
>>>
>>> *3. Advanced Concepts*
>>>
>>> *3.1 Multi-Environment-Support*
>>> *3.2 Configuration Providers*
>>> *3.3 Freezing, Serialization, Remoting*
>>>
>>> *4. Modules*
>>> *4.1 CDI/EE Integration*
>>> *4.2 Other Java EE Support*
>>> *4.3 JMX Management ?*
>>> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
>>> *4.3 ???*
>>>
>>> *5. Extensions*
>>> *5.1 Configuration Client/Server...?*
>>> *5.2 Configuration Server Setup UIs?*
>>>
>>> I propose to setup an asciidoc document for each part. That way we can
>>> compose a comprehensive design documentation easily step by step and also
>>> keep good focus on the aspects. As a starting I will try to update/split
>>> the existing document here (mirrored):
>>>
>>> https://github.com/apache/incubator-tamaya/blob/master/
>> api/src/main/asciidoc/JavaConfigSpecification.adoc
>>> Without bigger objections I will try to setup the document parts
>>> accordingly.
>>>
>>> Additionally I would propose to move them from
>>>    *api/src/main/asciidoc  *
>>> up to
>>> * api/doc/*
>>>
>>> So they are more easily accessible.
>>>
>>> Do you think this is a good way to start?
>>>
>>> Best,
>>> Anatole
>>>
>>>
>>>
>> --
>> N Oliver B. Fischer
>> A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
>> P +49 30 44793251
>> M +49 178 7903538
>> E o.b.fischer@swe-blog.net
>> S oliver.b.fischer
>> J oliver.b.fischer@jabber.org
>> X http://xing.to/obf
>>
>>

-- 
N Oliver B. Fischer
A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
P +49 30 44793251
M +49 178 7903538
E o.b.fischer@swe-blog.net
S oliver.b.fischer
J oliver.b.fischer@jabber.org
X http://xing.to/obf


Re: Tamaya Project Discussion

Posted by Anatole Tresch <at...@gmail.com>.
Hi Oli

I moved things into a docs module. (Currently not linked as a module of the
tamaya root pom so it will not build automatically. As well I separated
existing contents into subfiles, so we can more easily edit them.
So everybody is invited

- to review the use cases file
- add content to the requirements file
- read and comment on the first part of the core concepts file.

The ladder is as well a good starting point for a first discussion round
about the core concepts, especially property providers, environment and
configuration model.

Cheers,
Anatole
Oliver B. Fischer <o....@swe-blog.net> schrieb am Do., 27. Nov. 2014
um 22:42:

> @Anatole May we should move all the docs to a separate module? So it
> would be easier to include/exclude it from a build.
>
> Oliver
>
> Am 27.11.14 21:58, schrieb Anatole Tresch:
> > Dear all
> >
> > I would suggest to try to ramp up the discussions (and along with it
> > implementations) in the following way:
> >
> > *1. Use Cases and Requirements*
> >
> > *2. Core Concepts*
> > *2.1 Environment, Stage*
> > *2.2 PropertyProvider, Configuration and composite design*
> > *2.3 Change Listeners and Mutability*
> > *2.4 Extension Points*
> > *2.5 Additional Services (default provider implementations, combining and
> > filtering providers)*
> >
> > *3. Advanced Concepts*
> >
> > *3.1 Multi-Environment-Support*
> > *3.2 Configuration Providers*
> > *3.3 Freezing, Serialization, Remoting*
> >
> > *4. Modules*
> > *4.1 CDI/EE Integration*
> > *4.2 Other Java EE Support*
> > *4.3 JMX Management ?*
> > *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
> > *4.3 ???*
> >
> > *5. Extensions*
> > *5.1 Configuration Client/Server...?*
> > *5.2 Configuration Server Setup UIs?*
> >
> > I propose to setup an asciidoc document for each part. That way we can
> > compose a comprehensive design documentation easily step by step and also
> > keep good focus on the aspects. As a starting I will try to update/split
> > the existing document here (mirrored):
> >
> > https://github.com/apache/incubator-tamaya/blob/master/
> api/src/main/asciidoc/JavaConfigSpecification.adoc
> >
> > Without bigger objections I will try to setup the document parts
> > accordingly.
> >
> > Additionally I would propose to move them from
> >   *api/src/main/asciidoc  *
> > up to
> > * api/doc/*
> >
> > So they are more easily accessible.
> >
> > Do you think this is a good way to start?
> >
> > Best,
> > Anatole
> >
> >
> >
>
> --
> N Oliver B. Fischer
> A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
> P +49 30 44793251
> M +49 178 7903538
> E o.b.fischer@swe-blog.net
> S oliver.b.fischer
> J oliver.b.fischer@jabber.org
> X http://xing.to/obf
>
>

Re: Tamaya Project Discussion

Posted by Anatole Tresch <at...@gmail.com>.
I would not necessarily do so, because:


   - we can exclude them from the build easily by just moving the document
   generation into a profile
   - adding up the documentation to a nice assembly is more difficult if
   things are outside of the module

Other opinions ?


2014-11-27 22:40 GMT+01:00 Oliver B. Fischer <o....@swe-blog.net>:

> @Anatole May we should move all the docs to a separate module? So it would
> be easier to include/exclude it from a build.
>
> Oliver
>
> Am 27.11.14 21:58, schrieb Anatole Tresch:
>
>> Dear all
>>
>> I would suggest to try to ramp up the discussions (and along with it
>> implementations) in the following way:
>>
>> *1. Use Cases and Requirements*
>>
>> *2. Core Concepts*
>> *2.1 Environment, Stage*
>> *2.2 PropertyProvider, Configuration and composite design*
>> *2.3 Change Listeners and Mutability*
>> *2.4 Extension Points*
>> *2.5 Additional Services (default provider implementations, combining and
>> filtering providers)*
>>
>> *3. Advanced Concepts*
>>
>> *3.1 Multi-Environment-Support*
>> *3.2 Configuration Providers*
>> *3.3 Freezing, Serialization, Remoting*
>>
>> *4. Modules*
>> *4.1 CDI/EE Integration*
>> *4.2 Other Java EE Support*
>> *4.3 JMX Management ?*
>> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
>> *4.3 ???*
>>
>> *5. Extensions*
>> *5.1 Configuration Client/Server...?*
>> *5.2 Configuration Server Setup UIs?*
>>
>> I propose to setup an asciidoc document for each part. That way we can
>> compose a comprehensive design documentation easily step by step and also
>> keep good focus on the aspects. As a starting I will try to update/split
>> the existing document here (mirrored):
>>
>> https://github.com/apache/incubator-tamaya/blob/master/
>> api/src/main/asciidoc/JavaConfigSpecification.adoc
>>
>> Without bigger objections I will try to setup the document parts
>> accordingly.
>>
>> Additionally I would propose to move them from
>>   *api/src/main/asciidoc  *
>> up to
>> * api/doc/*
>>
>> So they are more easily accessible.
>>
>> Do you think this is a good way to start?
>>
>> Best,
>> Anatole
>>
>>
>>
>>
> --
> N Oliver B. Fischer
> A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
> P +49 30 44793251
> M +49 178 7903538
> E o.b.fischer@swe-blog.net
> S oliver.b.fischer
> J oliver.b.fischer@jabber.org
> X http://xing.to/obf
>
>


-- 
*Anatole Tresch*
Java Engineer & Architect, JSR Spec Lead
Glärnischweg 10
CH - 8620 Wetzikon

*Switzerland, Europe Zurich, GMT+1*
*Twitter:  @atsticks*
*Blogs: **http://javaremarkables.blogspot.ch/
<http://javaremarkables.blogspot.ch/>*

*Google: atsticksMobile  +41-76 344 62 79*

Re: Tamaya Project Discussion

Posted by "Oliver B. Fischer" <o....@swe-blog.net>.
@Anatole May we should move all the docs to a separate module? So it 
would be easier to include/exclude it from a build.

Oliver

Am 27.11.14 21:58, schrieb Anatole Tresch:
> Dear all
>
> I would suggest to try to ramp up the discussions (and along with it
> implementations) in the following way:
>
> *1. Use Cases and Requirements*
>
> *2. Core Concepts*
> *2.1 Environment, Stage*
> *2.2 PropertyProvider, Configuration and composite design*
> *2.3 Change Listeners and Mutability*
> *2.4 Extension Points*
> *2.5 Additional Services (default provider implementations, combining and
> filtering providers)*
>
> *3. Advanced Concepts*
>
> *3.1 Multi-Environment-Support*
> *3.2 Configuration Providers*
> *3.3 Freezing, Serialization, Remoting*
>
> *4. Modules*
> *4.1 CDI/EE Integration*
> *4.2 Other Java EE Support*
> *4.3 JMX Management ?*
> *4.4 Default Java EE Configuration (EE ready solution working OOTB)*
> *4.3 ???*
>
> *5. Extensions*
> *5.1 Configuration Client/Server...?*
> *5.2 Configuration Server Setup UIs?*
>
> I propose to setup an asciidoc document for each part. That way we can
> compose a comprehensive design documentation easily step by step and also
> keep good focus on the aspects. As a starting I will try to update/split
> the existing document here (mirrored):
>
> https://github.com/apache/incubator-tamaya/blob/master/api/src/main/asciidoc/JavaConfigSpecification.adoc
>
> Without bigger objections I will try to setup the document parts
> accordingly.
>
> Additionally I would propose to move them from
>   *api/src/main/asciidoc  *
> up to
> * api/doc/*
>
> So they are more easily accessible.
>
> Do you think this is a good way to start?
>
> Best,
> Anatole
>
>
>

-- 
N Oliver B. Fischer
A Schönhauser Allee 64, 10437 Berlin, Deutschland/Germany
P +49 30 44793251
M +49 178 7903538
E o.b.fischer@swe-blog.net
S oliver.b.fischer
J oliver.b.fischer@jabber.org
X http://xing.to/obf