How are we going to use the Tuscany Wiki space?

2007-06-15 Thread Mike Edwards

Folks,

I'm a bit confused (nothing out of the ordinary there then!) about how 
we intend to use the new Tuscany Wiki space.


So, the Apache Tuscany space is the material which makes up the external 
Tuscany website.  I understand our desire to control the update of 
material there - hence there is a restricted list of people who can edit 
pages there.


So, I thought, perhaps wrongly, that the Tuscany Wiki space was created 
to be a space "open to all" where any kind of material can be placed by 
anyone.  This includes different sorts of stuff, I think:


a) Material that is being prepared for the Tuscany website, so that it 
can be checked out before it goes live.


b) Discussion and similar material that is useful to help the work 
within the Tuscany community, but which may never reach the public 
website, such as design ideas related to discussions in the mailing list 
(good example is the stuff Simon Laws has created relating to 
distributed runtime).


Currently, the material in the Tuscany Wiki space is simply a mirror of 
the Apache Tuscany space.  I don't think that this is right.  First, 
simply repeating everything that is in the main space is confusing at 
best.  Worse, there needs to be some explanation of the use of the space 
and some specific navigation available, such as where to create new 
material and, for material intended for the main Tuscany website, some 
explanation of the process.


I'd like folks views on this.  If you agree with me, then I suggest that 
we should:


a) Rewrite the front page of the Tuscany Wiki to explain its purpose
b) Remove the Tuscany Wiki pages that are mere copies of pages on the 
main Wiki and adjust the navigation to separate out discussion pages 
from pages being prepared for the main site
c) Provide an explanation of how to write pages intended for the main 
Tuscany website and the process for getting them there...


Thoughts?


Yours,  Mike.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: How are we going to use the Tuscany Wiki space?

2007-06-15 Thread Venkata Krishnan

Hi Mike,

I agree we need to put some information on the Home page of the TUSCANYWIKI,
related to how the wiki is to be used - alteast earmark some place in the
page hierarchy under which discussion pages should go and how content for
website should be contributed.

As far as the copying of pages over to TUSCANYWIKI from TUSCANY is
concerned, I thought it would be easy for folks wanting to contribute to
website to be able to position their contributions better with respect to
the site structure.  This would get easier if contributions are coming as
corrections or additions to existing pages.

Am I missing a better way of doing this?

- Venkat

On 6/15/07, Mike Edwards <[EMAIL PROTECTED]> wrote:


Folks,

I'm a bit confused (nothing out of the ordinary there then!) about how
we intend to use the new Tuscany Wiki space.

So, the Apache Tuscany space is the material which makes up the external
Tuscany website.  I understand our desire to control the update of
material there - hence there is a restricted list of people who can edit
pages there.

So, I thought, perhaps wrongly, that the Tuscany Wiki space was created
to be a space "open to all" where any kind of material can be placed by
anyone.  This includes different sorts of stuff, I think:

a) Material that is being prepared for the Tuscany website, so that it
can be checked out before it goes live.

b) Discussion and similar material that is useful to help the work
within the Tuscany community, but which may never reach the public
website, such as design ideas related to discussions in the mailing list
(good example is the stuff Simon Laws has created relating to
distributed runtime).

Currently, the material in the Tuscany Wiki space is simply a mirror of
the Apache Tuscany space.  I don't think that this is right.  First,
simply repeating everything that is in the main space is confusing at
best.  Worse, there needs to be some explanation of the use of the space
and some specific navigation available, such as where to create new
material and, for material intended for the main Tuscany website, some
explanation of the process.

I'd like folks views on this.  If you agree with me, then I suggest that
we should:

a) Rewrite the front page of the Tuscany Wiki to explain its purpose
b) Remove the Tuscany Wiki pages that are mere copies of pages on the
main Wiki and adjust the navigation to separate out discussion pages
from pages being prepared for the main site
c) Provide an explanation of how to write pages intended for the main
Tuscany website and the process for getting them there...

Thoughts?


Yours,  Mike.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]




Re: How are we going to use the Tuscany Wiki space?

2007-06-15 Thread Simon Laws

I agree. Looking at it now it is confusing with the complete copy of the web
site material presented on the front page. It's not clear where the
definitive source of this material is.

+1 to the proposal for changing the front page of TUSCANYWIKI. I would have
thought we can just start with a subpage of TUSCANYWIKI for "main site pages
in preparation". Everthing else is wiki content with an organization of our
choosing.

Regards

Simon


Re: How are we going to use the Tuscany Wiki space?

2007-06-15 Thread Simon Nash

I'd like to retain the copied pages from the Tuscany web site.  As Venkat
said, this makes it easy for non-committers to develop and preview proposed
updates to the Web site.  I agree that it would be good to create a new
front page for the Wiki, with the copied Web site home page
  http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
linked from the TUSCANYWIKI front page.

  Simon

Simon Laws wrote:

I agree. Looking at it now it is confusing with the complete copy of the 
web

site material presented on the front page. It's not clear where the
definitive source of this material is.

+1 to the proposal for changing the front page of TUSCANYWIKI. I would have
thought we can just start with a subpage of TUSCANYWIKI for "main site 
pages

in preparation". Everthing else is wiki content with an organization of our
choosing.

Regards

Simon





-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: How are we going to use the Tuscany Wiki space?

2007-06-30 Thread Simon Laws

On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:


I'd like to retain the copied pages from the Tuscany web site.  As Venkat
said, this makes it easy for non-committers to develop and preview
proposed
updates to the Web site.  I agree that it would be good to create a new
front page for the Wiki, with the copied Web site home page
   http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
linked from the TUSCANYWIKI front page.

   Simon

Simon Laws wrote:

> I agree. Looking at it now it is confusing with the complete copy of the
> web
> site material presented on the front page. It's not clear where the
> definitive source of this material is.
>
> +1 to the proposal for changing the front page of TUSCANYWIKI. I would
have
> thought we can just start with a subpage of TUSCANYWIKI for "main site
> pages
> in preparation". Everthing else is wiki content with an organization of
our
> choosing.
>
> Regards
>
> Simon
>



-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



I've had a go at reorganizing the front page of the wiki. But it's a wiki so
if you don't like it

Simon


Re: How are we going to use the Tuscany Wiki space?

2007-06-30 Thread Luciano Resende

I'd like to propose using a structure similar to the one described
below to group documents together and make it easier to find related
information. It's probably good not to have very deep hierarchy, and
maybe start grouping things on a specific level via page name (e.g
distribution-import-export, distribution-model, etc)

  SCA Java Project
 |
 |--- SCA related Documents

  SDO Java Project
 |
 |--- SDO related Documents

  DAS Java Project
 |
 |--- DAS related Documents

  Infrastructure
 |
 |--- Infra related Documents such as builds, sync, etc

  Website
 |
 |--- Website related documents and old website copy

Thoughts ?

On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:

On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
>
> I'd like to retain the copied pages from the Tuscany web site.  As Venkat
> said, this makes it easy for non-committers to develop and preview
> proposed
> updates to the Web site.  I agree that it would be good to create a new
> front page for the Wiki, with the copied Web site home page
>http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
> linked from the TUSCANYWIKI front page.
>
>Simon
>
> Simon Laws wrote:
>
> > I agree. Looking at it now it is confusing with the complete copy of the
> > web
> > site material presented on the front page. It's not clear where the
> > definitive source of this material is.
> >
> > +1 to the proposal for changing the front page of TUSCANYWIKI. I would
> have
> > thought we can just start with a subpage of TUSCANYWIKI for "main site
> > pages
> > in preparation". Everthing else is wiki content with an organization of
> our
> > choosing.
> >
> > Regards
> >
> > Simon
> >
>
>
>
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]


I've had a go at reorganizing the front page of the wiki. But it's a wiki so
if you don't like it

Simon




--
Luciano Resende
Apache Tuscany Committer
http://people.apache.org/~lresende
http://lresende.blogspot.com/

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: How are we going to use the Tuscany Wiki space?

2007-07-01 Thread Simon Laws

On 7/1/07, Luciano Resende <[EMAIL PROTECTED]> wrote:


I'd like to propose using a structure similar to the one described
below to group documents together and make it easier to find related
information. It's probably good not to have very deep hierarchy, and
maybe start grouping things on a specific level via page name (e.g
distribution-import-export, distribution-model, etc)

   SCA Java Project
  |
  |--- SCA related Documents

   SDO Java Project
  |
  |--- SDO related Documents

   DAS Java Project
  |
  |--- DAS related Documents

   Infrastructure
  |
  |--- Infra related Documents such as builds, sync, etc

   Website
  |
  |--- Website related documents and old website copy

Thoughts ?



Sounds Ok to me. I don't think we need to make it any more complicated than
this single set of groupings in the first instance. Lets see how people use
it.

Simon


Re: How are we going to use the Tuscany Wiki space?

2007-07-01 Thread Mike Edwards

Luciano,

How does this compare with the existing structure?  This seems to 
approach things from a "Java" perspective rather than an "SCA" / "SDO" 
perspective - is that right?


It might be useful to create an example of what you mean in the 
TuscanyWiki psace...



Yours,  Mike.

Luciano Resende wrote:

I'd like to propose using a structure similar to the one described
below to group documents together and make it easier to find related
information. It's probably good not to have very deep hierarchy, and
maybe start grouping things on a specific level via page name (e.g
distribution-import-export, distribution-model, etc)

  SCA Java Project
 |
 |--- SCA related Documents

  SDO Java Project
 |
 |--- SDO related Documents

  DAS Java Project
 |
 |--- DAS related Documents

  Infrastructure
 |
 |--- Infra related Documents such as builds, sync, etc

  Website
 |
 |--- Website related documents and old website copy

Thoughts ?

On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:


On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
>
> I'd like to retain the copied pages from the Tuscany web site.  As 
Venkat

> said, this makes it easy for non-committers to develop and preview
> proposed
> updates to the Web site.  I agree that it would be good to create a new
> front page for the Wiki, with the copied Web site home page
>http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
> linked from the TUSCANYWIKI front page.
>
>Simon
>
> Simon Laws wrote:
>
> > I agree. Looking at it now it is confusing with the complete copy 
of the

> > web
> > site material presented on the front page. It's not clear where the
> > definitive source of this material is.
> >
> > +1 to the proposal for changing the front page of TUSCANYWIKI. I 
would

> have
> > thought we can just start with a subpage of TUSCANYWIKI for "main 
site

> > pages
> > in preparation". Everthing else is wiki content with an 
organization of

> our
> > choosing.
> >
> > Regards
> >
> > Simon
> >
>
>
>
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]


I've had a go at reorganizing the front page of the wiki. But it's a 
wiki so

if you don't like it

Simon






-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: How are we going to use the Tuscany Wiki space?

2007-07-01 Thread Luciano Resende

I'd say, SCA Native Project would be on the same level of SCA Java
Project. I think what we have today on the website is similar to this,
but it gives the distinction between Java/C++ in a deeper level, and
for the tuscanywiki space, i think we can avoid this extra level. The
main goal here is group related information together in a organized
way, and try to avoid content to be put directly on the root level of
the tuscanywiki.

The TuscanyWiki space already have part of what I described, but not
many content, other then the copy of the old website is available as
of now.

Thoughts ?

On 7/1/07, Mike Edwards <[EMAIL PROTECTED]> wrote:

Luciano,

How does this compare with the existing structure?  This seems to
approach things from a "Java" perspective rather than an "SCA" / "SDO"
perspective - is that right?

It might be useful to create an example of what you mean in the
TuscanyWiki psace...


Yours,  Mike.

Luciano Resende wrote:
> I'd like to propose using a structure similar to the one described
> below to group documents together and make it easier to find related
> information. It's probably good not to have very deep hierarchy, and
> maybe start grouping things on a specific level via page name (e.g
> distribution-import-export, distribution-model, etc)
>
>   SCA Java Project
>  |
>  |--- SCA related Documents
>
>   SDO Java Project
>  |
>  |--- SDO related Documents
>
>   DAS Java Project
>  |
>  |--- DAS related Documents
>
>   Infrastructure
>  |
>  |--- Infra related Documents such as builds, sync, etc
>
>   Website
>  |
>  |--- Website related documents and old website copy
>
> Thoughts ?
>
> On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:
>
>> On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
>> >
>> > I'd like to retain the copied pages from the Tuscany web site.  As
>> Venkat
>> > said, this makes it easy for non-committers to develop and preview
>> > proposed
>> > updates to the Web site.  I agree that it would be good to create a new
>> > front page for the Wiki, with the copied Web site home page
>> >http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
>> > linked from the TUSCANYWIKI front page.
>> >
>> >Simon
>> >
>> > Simon Laws wrote:
>> >
>> > > I agree. Looking at it now it is confusing with the complete copy
>> of the
>> > > web
>> > > site material presented on the front page. It's not clear where the
>> > > definitive source of this material is.
>> > >
>> > > +1 to the proposal for changing the front page of TUSCANYWIKI. I
>> would
>> > have
>> > > thought we can just start with a subpage of TUSCANYWIKI for "main
>> site
>> > > pages
>> > > in preparation". Everthing else is wiki content with an
>> organization of
>> > our
>> > > choosing.
>> > >
>> > > Regards
>> > >
>> > > Simon
>> > >
>> >
>> >
>> >
>> > -
>> > To unsubscribe, e-mail: [EMAIL PROTECTED]
>> > For additional commands, e-mail: [EMAIL PROTECTED]
>>
>>
>> I've had a go at reorganizing the front page of the wiki. But it's a
>> wiki so
>> if you don't like it
>>
>> Simon
>>
>
>

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]





--
Luciano Resende
Apache Tuscany Committer
http://people.apache.org/~lresende
http://lresende.blogspot.com/

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: How are we going to use the Tuscany Wiki space?

2007-07-02 Thread haleh mahbod

I agree with Simon Nash that we need a manual copy of the 'whole' website on
TuscanyWiki since otherwise it will be very difficult for those who are not
committers to see what their changes look like.  I re-organized the wiki
before it got locked and I would have not been able to do it if I could not
see how my changes affected the navigation and flow of things.

Tuscany wiki was organized in such a way that all related documentation for
each subproject appeared under that subproject and there were two categories
under documentation 1) Completed documentation 2) work in progress
It would be good to maintain this for clarity.



On 7/1/07, Luciano Resende <[EMAIL PROTECTED]> wrote:


I'd say, SCA Native Project would be on the same level of SCA Java
Project. I think what we have today on the website is similar to this,
but it gives the distinction between Java/C++ in a deeper level, and
for the tuscanywiki space, i think we can avoid this extra level. The
main goal here is group related information together in a organized
way, and try to avoid content to be put directly on the root level of
the tuscanywiki.

The TuscanyWiki space already have part of what I described, but not
many content, other then the copy of the old website is available as
of now.

Thoughts ?

On 7/1/07, Mike Edwards <[EMAIL PROTECTED]> wrote:
> Luciano,
>
> How does this compare with the existing structure?  This seems to
> approach things from a "Java" perspective rather than an "SCA" / "SDO"
> perspective - is that right?
>
> It might be useful to create an example of what you mean in the
> TuscanyWiki psace...
>
>
> Yours,  Mike.
>
> Luciano Resende wrote:
> > I'd like to propose using a structure similar to the one described
> > below to group documents together and make it easier to find related
> > information. It's probably good not to have very deep hierarchy, and
> > maybe start grouping things on a specific level via page name (e.g
> > distribution-import-export, distribution-model, etc)
> >
> >   SCA Java Project
> >  |
> >  |--- SCA related Documents
> >
> >   SDO Java Project
> >  |
> >  |--- SDO related Documents
> >
> >   DAS Java Project
> >  |
> >  |--- DAS related Documents
> >
> >   Infrastructure
> >  |
> >  |--- Infra related Documents such as builds, sync, etc
> >
> >   Website
> >  |
> >  |--- Website related documents and old website copy
> >
> > Thoughts ?
> >
> > On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> >
> >> On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
> >> >
> >> > I'd like to retain the copied pages from the Tuscany web site.  As
> >> Venkat
> >> > said, this makes it easy for non-committers to develop and preview
> >> > proposed
> >> > updates to the Web site.  I agree that it would be good to create a
new
> >> > front page for the Wiki, with the copied Web site home page
> >> >http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
> >> > linked from the TUSCANYWIKI front page.
> >> >
> >> >Simon
> >> >
> >> > Simon Laws wrote:
> >> >
> >> > > I agree. Looking at it now it is confusing with the complete copy
> >> of the
> >> > > web
> >> > > site material presented on the front page. It's not clear where
the
> >> > > definitive source of this material is.
> >> > >
> >> > > +1 to the proposal for changing the front page of TUSCANYWIKI. I
> >> would
> >> > have
> >> > > thought we can just start with a subpage of TUSCANYWIKI for "main
> >> site
> >> > > pages
> >> > > in preparation". Everthing else is wiki content with an
> >> organization of
> >> > our
> >> > > choosing.
> >> > >
> >> > > Regards
> >> > >
> >> > > Simon
> >> > >
> >> >
> >> >
> >> >
> >> >
-
> >> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> >> > For additional commands, e-mail: [EMAIL PROTECTED]
> >>
> >>
> >> I've had a go at reorganizing the front page of the wiki. But it's a
> >> wiki so
> >> if you don't like it
> >>
> >> Simon
> >>
> >
> >
>
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>


--
Luciano Resende
Apache Tuscany Committer
http://people.apache.org/~lresende
http://lresende.blogspot.com/

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]




Re: How are we going to use the Tuscany Wiki space?

2007-07-02 Thread Simon Laws

On 7/2/07, haleh mahbod <[EMAIL PROTECTED]> wrote:


I agree with Simon Nash that we need a manual copy of the 'whole' website
on
TuscanyWiki since otherwise it will be very difficult for those who are
not
committers to see what their changes look like.  I re-organized the wiki
before it got locked and I would have not been able to do it if I could
not
see how my changes affected the navigation and flow of things.

Tuscany wiki was organized in such a way that all related documentation
for
each subproject appeared under that subproject and there were two
categories
under documentation 1) Completed documentation 2) work in progress
It would be good to maintain this for clarity.



On 7/1/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
>
> I'd say, SCA Native Project would be on the same level of SCA Java
> Project. I think what we have today on the website is similar to this,
> but it gives the distinction between Java/C++ in a deeper level, and
> for the tuscanywiki space, i think we can avoid this extra level. The
> main goal here is group related information together in a organized
> way, and try to avoid content to be put directly on the root level of
> the tuscanywiki.
>
> The TuscanyWiki space already have part of what I described, but not
> many content, other then the copy of the old website is available as
> of now.
>
> Thoughts ?
>
> On 7/1/07, Mike Edwards <[EMAIL PROTECTED]> wrote:
> > Luciano,
> >
> > How does this compare with the existing structure?  This seems to
> > approach things from a "Java" perspective rather than an "SCA" / "SDO"
> > perspective - is that right?
> >
> > It might be useful to create an example of what you mean in the
> > TuscanyWiki psace...
> >
> >
> > Yours,  Mike.
> >
> > Luciano Resende wrote:
> > > I'd like to propose using a structure similar to the one described
> > > below to group documents together and make it easier to find related
> > > information. It's probably good not to have very deep hierarchy, and
> > > maybe start grouping things on a specific level via page name (e.g
> > > distribution-import-export, distribution-model, etc)
> > >
> > >   SCA Java Project
> > >  |
> > >  |--- SCA related Documents
> > >
> > >   SDO Java Project
> > >  |
> > >  |--- SDO related Documents
> > >
> > >   DAS Java Project
> > >  |
> > >  |--- DAS related Documents
> > >
> > >   Infrastructure
> > >  |
> > >  |--- Infra related Documents such as builds, sync, etc
> > >
> > >   Website
> > >  |
> > >  |--- Website related documents and old website copy
> > >
> > > Thoughts ?
> > >
> > > On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> > >
> > >> On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
> > >> >
> > >> > I'd like to retain the copied pages from the Tuscany web
site.  As
> > >> Venkat
> > >> > said, this makes it easy for non-committers to develop and
preview
> > >> > proposed
> > >> > updates to the Web site.  I agree that it would be good to create
a
> new
> > >> > front page for the Wiki, with the copied Web site home page
> > >> >http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
> > >> > linked from the TUSCANYWIKI front page.
> > >> >
> > >> >Simon
> > >> >
> > >> > Simon Laws wrote:
> > >> >
> > >> > > I agree. Looking at it now it is confusing with the complete
copy
> > >> of the
> > >> > > web
> > >> > > site material presented on the front page. It's not clear where
> the
> > >> > > definitive source of this material is.
> > >> > >
> > >> > > +1 to the proposal for changing the front page of TUSCANYWIKI.
I
> > >> would
> > >> > have
> > >> > > thought we can just start with a subpage of TUSCANYWIKI for
"main
> > >> site
> > >> > > pages
> > >> > > in preparation". Everthing else is wiki content with an
> > >> organization of
> > >> > our
> > >> > > choosing.
> > >> > >
> > >> > > Regards
> > >> > >
> > >> > > Simon
> > >> > >
> > >> >
> > >> >
> > >> >
> > >> >
> -
> > >> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > >> > For additional commands, e-mail: [EMAIL PROTECTED]
> > >>
> > >>
> > >> I've had a go at reorganizing the front page of the wiki. But it's
a
> > >> wiki so
> > >> if you don't like it
> > >>
> > >> Simon
> > >>
> > >
> > >
> >
> > -
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
> >
> >
>
>
> --
> Luciano Resende
> Apache Tuscany Committer
> http://people.apache.org/~lresende
> http://lresende.blogspot.com/
>
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>


There is a manual copy of the website on the wiki - see the link"Tuscany
Website Pages In
Preparation"
at the bottom o

Re: How are we going to use the Tuscany Wiki space?

2007-07-02 Thread Luciano Resende

+1 That's what I was thinking about... sorry if it was causing any confusion...

On 7/2/07, Simon Laws <[EMAIL PROTECTED]> wrote:

On 7/2/07, haleh mahbod <[EMAIL PROTECTED]> wrote:
>
> I agree with Simon Nash that we need a manual copy of the 'whole' website
> on
> TuscanyWiki since otherwise it will be very difficult for those who are
> not
> committers to see what their changes look like.  I re-organized the wiki
> before it got locked and I would have not been able to do it if I could
> not
> see how my changes affected the navigation and flow of things.
>
> Tuscany wiki was organized in such a way that all related documentation
> for
> each subproject appeared under that subproject and there were two
> categories
> under documentation 1) Completed documentation 2) work in progress
> It would be good to maintain this for clarity.
>
>
>
> On 7/1/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
> >
> > I'd say, SCA Native Project would be on the same level of SCA Java
> > Project. I think what we have today on the website is similar to this,
> > but it gives the distinction between Java/C++ in a deeper level, and
> > for the tuscanywiki space, i think we can avoid this extra level. The
> > main goal here is group related information together in a organized
> > way, and try to avoid content to be put directly on the root level of
> > the tuscanywiki.
> >
> > The TuscanyWiki space already have part of what I described, but not
> > many content, other then the copy of the old website is available as
> > of now.
> >
> > Thoughts ?
> >
> > On 7/1/07, Mike Edwards <[EMAIL PROTECTED]> wrote:
> > > Luciano,
> > >
> > > How does this compare with the existing structure?  This seems to
> > > approach things from a "Java" perspective rather than an "SCA" / "SDO"
> > > perspective - is that right?
> > >
> > > It might be useful to create an example of what you mean in the
> > > TuscanyWiki psace...
> > >
> > >
> > > Yours,  Mike.
> > >
> > > Luciano Resende wrote:
> > > > I'd like to propose using a structure similar to the one described
> > > > below to group documents together and make it easier to find related
> > > > information. It's probably good not to have very deep hierarchy, and
> > > > maybe start grouping things on a specific level via page name (e.g
> > > > distribution-import-export, distribution-model, etc)
> > > >
> > > >   SCA Java Project
> > > >  |
> > > >  |--- SCA related Documents
> > > >
> > > >   SDO Java Project
> > > >  |
> > > >  |--- SDO related Documents
> > > >
> > > >   DAS Java Project
> > > >  |
> > > >  |--- DAS related Documents
> > > >
> > > >   Infrastructure
> > > >  |
> > > >  |--- Infra related Documents such as builds, sync, etc
> > > >
> > > >   Website
> > > >  |
> > > >  |--- Website related documents and old website copy
> > > >
> > > > Thoughts ?
> > > >
> > > > On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> > > >
> > > >> On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
> > > >> >
> > > >> > I'd like to retain the copied pages from the Tuscany web
> site.  As
> > > >> Venkat
> > > >> > said, this makes it easy for non-committers to develop and
> preview
> > > >> > proposed
> > > >> > updates to the Web site.  I agree that it would be good to create
> a
> > new
> > > >> > front page for the Wiki, with the copied Web site home page
> > > >> >http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
> > > >> > linked from the TUSCANYWIKI front page.
> > > >> >
> > > >> >Simon
> > > >> >
> > > >> > Simon Laws wrote:
> > > >> >
> > > >> > > I agree. Looking at it now it is confusing with the complete
> copy
> > > >> of the
> > > >> > > web
> > > >> > > site material presented on the front page. It's not clear where
> > the
> > > >> > > definitive source of this material is.
> > > >> > >
> > > >> > > +1 to the proposal for changing the front page of TUSCANYWIKI.
> I
> > > >> would
> > > >> > have
> > > >> > > thought we can just start with a subpage of TUSCANYWIKI for
> "main
> > > >> site
> > > >> > > pages
> > > >> > > in preparation". Everthing else is wiki content with an
> > > >> organization of
> > > >> > our
> > > >> > > choosing.
> > > >> > >
> > > >> > > Regards
> > > >> > >
> > > >> > > Simon
> > > >> > >
> > > >> >
> > > >> >
> > > >> >
> > > >> >
> > -
> > > >> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > > >> > For additional commands, e-mail: [EMAIL PROTECTED]
> > > >>
> > > >>
> > > >> I've had a go at reorganizing the front page of the wiki. But it's
> a
> > > >> wiki so
> > > >> if you don't like it
> > > >>
> > > >> Simon
> > > >>
> > > >
> > > >
> > >
> > > -
> > > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > > For additional commands, e-mail: [EMAIL PROTECTED]
> > >
> > >
> >
> >
> > --
> > Luciano Resende
> > Apache Tuscany Committer
> > http://people.apache.o

Re: How are we going to use the Tuscany Wiki space?

2007-07-06 Thread Luciano Resende

Following a related topic, should we move all the "work in progress"
documents that are child pages from [1] from the website to the wiki.
I think this would allow for more collaboration and help from other
members of the community.

[1] http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Work-In-Progress

On 7/2/07, Luciano Resende <[EMAIL PROTECTED]> wrote:

+1 That's what I was thinking about... sorry if it was causing any confusion...

On 7/2/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> On 7/2/07, haleh mahbod <[EMAIL PROTECTED]> wrote:
> >
> > I agree with Simon Nash that we need a manual copy of the 'whole' website
> > on
> > TuscanyWiki since otherwise it will be very difficult for those who are
> > not
> > committers to see what their changes look like.  I re-organized the wiki
> > before it got locked and I would have not been able to do it if I could
> > not
> > see how my changes affected the navigation and flow of things.
> >
> > Tuscany wiki was organized in such a way that all related documentation
> > for
> > each subproject appeared under that subproject and there were two
> > categories
> > under documentation 1) Completed documentation 2) work in progress
> > It would be good to maintain this for clarity.
> >
> >
> >
> > On 7/1/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
> > >
> > > I'd say, SCA Native Project would be on the same level of SCA Java
> > > Project. I think what we have today on the website is similar to this,
> > > but it gives the distinction between Java/C++ in a deeper level, and
> > > for the tuscanywiki space, i think we can avoid this extra level. The
> > > main goal here is group related information together in a organized
> > > way, and try to avoid content to be put directly on the root level of
> > > the tuscanywiki.
> > >
> > > The TuscanyWiki space already have part of what I described, but not
> > > many content, other then the copy of the old website is available as
> > > of now.
> > >
> > > Thoughts ?
> > >
> > > On 7/1/07, Mike Edwards <[EMAIL PROTECTED]> wrote:
> > > > Luciano,
> > > >
> > > > How does this compare with the existing structure?  This seems to
> > > > approach things from a "Java" perspective rather than an "SCA" / "SDO"
> > > > perspective - is that right?
> > > >
> > > > It might be useful to create an example of what you mean in the
> > > > TuscanyWiki psace...
> > > >
> > > >
> > > > Yours,  Mike.
> > > >
> > > > Luciano Resende wrote:
> > > > > I'd like to propose using a structure similar to the one described
> > > > > below to group documents together and make it easier to find related
> > > > > information. It's probably good not to have very deep hierarchy, and
> > > > > maybe start grouping things on a specific level via page name (e.g
> > > > > distribution-import-export, distribution-model, etc)
> > > > >
> > > > >   SCA Java Project
> > > > >  |
> > > > >  |--- SCA related Documents
> > > > >
> > > > >   SDO Java Project
> > > > >  |
> > > > >  |--- SDO related Documents
> > > > >
> > > > >   DAS Java Project
> > > > >  |
> > > > >  |--- DAS related Documents
> > > > >
> > > > >   Infrastructure
> > > > >  |
> > > > >  |--- Infra related Documents such as builds, sync, etc
> > > > >
> > > > >   Website
> > > > >  |
> > > > >  |--- Website related documents and old website copy
> > > > >
> > > > > Thoughts ?
> > > > >
> > > > > On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> > > > >
> > > > >> On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
> > > > >> >
> > > > >> > I'd like to retain the copied pages from the Tuscany web
> > site.  As
> > > > >> Venkat
> > > > >> > said, this makes it easy for non-committers to develop and
> > preview
> > > > >> > proposed
> > > > >> > updates to the Web site.  I agree that it would be good to create
> > a
> > > new
> > > > >> > front page for the Wiki, with the copied Web site home page
> > > > >> >http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
> > > > >> > linked from the TUSCANYWIKI front page.
> > > > >> >
> > > > >> >Simon
> > > > >> >
> > > > >> > Simon Laws wrote:
> > > > >> >
> > > > >> > > I agree. Looking at it now it is confusing with the complete
> > copy
> > > > >> of the
> > > > >> > > web
> > > > >> > > site material presented on the front page. It's not clear where
> > > the
> > > > >> > > definitive source of this material is.
> > > > >> > >
> > > > >> > > +1 to the proposal for changing the front page of TUSCANYWIKI.
> > I
> > > > >> would
> > > > >> > have
> > > > >> > > thought we can just start with a subpage of TUSCANYWIKI for
> > "main
> > > > >> site
> > > > >> > > pages
> > > > >> > > in preparation". Everthing else is wiki content with an
> > > > >> organization of
> > > > >> > our
> > > > >> > > choosing.
> > > > >> > >
> > > > >> > > Regards
> > > > >> > >
> > > > >> > > Simon
> > > > >> > >
> > > > >> >
> > > > >> >
> > > > >> >
> > > > >> >
> > > 

Re: How are we going to use the Tuscany Wiki space?

2007-07-06 Thread haleh mahbod

Purpose of the 'work in progress folder' was just what you mentioned below.
It's been a while since that folder was created. Perhaps we should look at
the content and figure out what is mature enough to be added to the website
before we move everything back to TuscanyWiki.

On 7/6/07, Luciano Resende <[EMAIL PROTECTED]> wrote:


Following a related topic, should we move all the "work in progress"
documents that are child pages from [1] from the website to the wiki.
I think this would allow for more collaboration and help from other
members of the community.

[1]
http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Work-In-Progress

On 7/2/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
> +1 That's what I was thinking about... sorry if it was causing any
confusion...
>
> On 7/2/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> > On 7/2/07, haleh mahbod <[EMAIL PROTECTED]> wrote:
> > >
> > > I agree with Simon Nash that we need a manual copy of the 'whole'
website
> > > on
> > > TuscanyWiki since otherwise it will be very difficult for those who
are
> > > not
> > > committers to see what their changes look like.  I re-organized the
wiki
> > > before it got locked and I would have not been able to do it if I
could
> > > not
> > > see how my changes affected the navigation and flow of things.
> > >
> > > Tuscany wiki was organized in such a way that all related
documentation
> > > for
> > > each subproject appeared under that subproject and there were two
> > > categories
> > > under documentation 1) Completed documentation 2) work in progress
> > > It would be good to maintain this for clarity.
> > >
> > >
> > >
> > > On 7/1/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
> > > >
> > > > I'd say, SCA Native Project would be on the same level of SCA Java
> > > > Project. I think what we have today on the website is similar to
this,
> > > > but it gives the distinction between Java/C++ in a deeper level,
and
> > > > for the tuscanywiki space, i think we can avoid this extra level.
The
> > > > main goal here is group related information together in a
organized
> > > > way, and try to avoid content to be put directly on the root level
of
> > > > the tuscanywiki.
> > > >
> > > > The TuscanyWiki space already have part of what I described, but
not
> > > > many content, other then the copy of the old website is available
as
> > > > of now.
> > > >
> > > > Thoughts ?
> > > >
> > > > On 7/1/07, Mike Edwards <[EMAIL PROTECTED]> wrote:
> > > > > Luciano,
> > > > >
> > > > > How does this compare with the existing structure?  This seems
to
> > > > > approach things from a "Java" perspective rather than an "SCA" /
"SDO"
> > > > > perspective - is that right?
> > > > >
> > > > > It might be useful to create an example of what you mean in the
> > > > > TuscanyWiki psace...
> > > > >
> > > > >
> > > > > Yours,  Mike.
> > > > >
> > > > > Luciano Resende wrote:
> > > > > > I'd like to propose using a structure similar to the one
described
> > > > > > below to group documents together and make it easier to find
related
> > > > > > information. It's probably good not to have very deep
hierarchy, and
> > > > > > maybe start grouping things on a specific level via page name
(e.g
> > > > > > distribution-import-export, distribution-model, etc)
> > > > > >
> > > > > >   SCA Java Project
> > > > > >  |
> > > > > >  |--- SCA related Documents
> > > > > >
> > > > > >   SDO Java Project
> > > > > >  |
> > > > > >  |--- SDO related Documents
> > > > > >
> > > > > >   DAS Java Project
> > > > > >  |
> > > > > >  |--- DAS related Documents
> > > > > >
> > > > > >   Infrastructure
> > > > > >  |
> > > > > >  |--- Infra related Documents such as builds, sync, etc
> > > > > >
> > > > > >   Website
> > > > > >  |
> > > > > >  |--- Website related documents and old website copy
> > > > > >
> > > > > > Thoughts ?
> > > > > >
> > > > > > On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> > > > > >
> > > > > >> On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
> > > > > >> >
> > > > > >> > I'd like to retain the copied pages from the Tuscany web
> > > site.  As
> > > > > >> Venkat
> > > > > >> > said, this makes it easy for non-committers to develop and
> > > preview
> > > > > >> > proposed
> > > > > >> > updates to the Web site.  I agree that it would be good to
create
> > > a
> > > > new
> > > > > >> > front page for the Wiki, with the copied Web site home page
> > > > > >> >
http://cwiki.apache.org/confluence/display/TUSCANYWIKI/Home
> > > > > >> > linked from the TUSCANYWIKI front page.
> > > > > >> >
> > > > > >> >Simon
> > > > > >> >
> > > > > >> > Simon Laws wrote:
> > > > > >> >
> > > > > >> > > I agree. Looking at it now it is confusing with the
complete
> > > copy
> > > > > >> of the
> > > > > >> > > web
> > > > > >> > > site material presented on the front page. It's not clear
where
> > > > the
> > > > > >> > > definitive source of this material is.
> > > > > >> > >
> > > > > >> > > +1 to the

Re: How are we going to use the Tuscany Wiki space?

2007-07-06 Thread Luciano Resende

Yes, I understand the purpose, but I also understand that the ACL of
the website has changed since that time, that's why I was proposing
move it to the regular wiki, where more people would have access to
contribute to these documents.  And yes, if we feel these documents
are ready to be published to the website, we should link them from the
documentation page and move them out of the "work in progress" page.

On 7/6/07, haleh mahbod <[EMAIL PROTECTED]> wrote:

Purpose of the 'work in progress folder' was just what you mentioned below.
It's been a while since that folder was created. Perhaps we should look at
the content and figure out what is mature enough to be added to the website
before we move everything back to TuscanyWiki.

On 7/6/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
>
> Following a related topic, should we move all the "work in progress"
> documents that are child pages from [1] from the website to the wiki.
> I think this would allow for more collaboration and help from other
> members of the community.
>
> [1]
> http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Work-In-Progress
>
> On 7/2/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
> > +1 That's what I was thinking about... sorry if it was causing any
> confusion...
> >
> > On 7/2/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> > > On 7/2/07, haleh mahbod <[EMAIL PROTECTED]> wrote:
> > > >
> > > > I agree with Simon Nash that we need a manual copy of the 'whole'
> website
> > > > on
> > > > TuscanyWiki since otherwise it will be very difficult for those who
> are
> > > > not
> > > > committers to see what their changes look like.  I re-organized the
> wiki
> > > > before it got locked and I would have not been able to do it if I
> could
> > > > not
> > > > see how my changes affected the navigation and flow of things.
> > > >
> > > > Tuscany wiki was organized in such a way that all related
> documentation
> > > > for
> > > > each subproject appeared under that subproject and there were two
> > > > categories
> > > > under documentation 1) Completed documentation 2) work in progress
> > > > It would be good to maintain this for clarity.
> > > >
> > > >
> > > >
> > > > On 7/1/07, Luciano Resende <[EMAIL PROTECTED]> wrote:
> > > > >
> > > > > I'd say, SCA Native Project would be on the same level of SCA Java
> > > > > Project. I think what we have today on the website is similar to
> this,
> > > > > but it gives the distinction between Java/C++ in a deeper level,
> and
> > > > > for the tuscanywiki space, i think we can avoid this extra level.
> The
> > > > > main goal here is group related information together in a
> organized
> > > > > way, and try to avoid content to be put directly on the root level
> of
> > > > > the tuscanywiki.
> > > > >
> > > > > The TuscanyWiki space already have part of what I described, but
> not
> > > > > many content, other then the copy of the old website is available
> as
> > > > > of now.
> > > > >
> > > > > Thoughts ?
> > > > >
> > > > > On 7/1/07, Mike Edwards <[EMAIL PROTECTED]> wrote:
> > > > > > Luciano,
> > > > > >
> > > > > > How does this compare with the existing structure?  This seems
> to
> > > > > > approach things from a "Java" perspective rather than an "SCA" /
> "SDO"
> > > > > > perspective - is that right?
> > > > > >
> > > > > > It might be useful to create an example of what you mean in the
> > > > > > TuscanyWiki psace...
> > > > > >
> > > > > >
> > > > > > Yours,  Mike.
> > > > > >
> > > > > > Luciano Resende wrote:
> > > > > > > I'd like to propose using a structure similar to the one
> described
> > > > > > > below to group documents together and make it easier to find
> related
> > > > > > > information. It's probably good not to have very deep
> hierarchy, and
> > > > > > > maybe start grouping things on a specific level via page name
> (e.g
> > > > > > > distribution-import-export, distribution-model, etc)
> > > > > > >
> > > > > > >   SCA Java Project
> > > > > > >  |
> > > > > > >  |--- SCA related Documents
> > > > > > >
> > > > > > >   SDO Java Project
> > > > > > >  |
> > > > > > >  |--- SDO related Documents
> > > > > > >
> > > > > > >   DAS Java Project
> > > > > > >  |
> > > > > > >  |--- DAS related Documents
> > > > > > >
> > > > > > >   Infrastructure
> > > > > > >  |
> > > > > > >  |--- Infra related Documents such as builds, sync, etc
> > > > > > >
> > > > > > >   Website
> > > > > > >  |
> > > > > > >  |--- Website related documents and old website copy
> > > > > > >
> > > > > > > Thoughts ?
> > > > > > >
> > > > > > > On 6/30/07, Simon Laws <[EMAIL PROTECTED]> wrote:
> > > > > > >
> > > > > > >> On 6/15/07, Simon Nash <[EMAIL PROTECTED]> wrote:
> > > > > > >> >
> > > > > > >> > I'd like to retain the copied pages from the Tuscany web
> > > > site.  As
> > > > > > >> Venkat
> > > > > > >> > said, this makes it easy for non-committers to develop and
> > > > preview
> > > > > > >> > proposed
> > > > > > >> > updates to