You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@openwebbeans.apache.org by Karl Kildén <ka...@gmail.com> on 2013/10/01 20:54:53 UTC
Documentation layout suggestions
First things first. We really need to finish the "getting started" part.
Getting started with OWB is not even that much information to condense.
While I start with that, please give your input to the documentation
layout. This is basically what you should see when you click
"Documentation". Me and Mark discussed it for 2 minutes and have two basic
(and very similar) suggestions. Wdyt?
Suggestion 1:
Second link "*OWB explained*" is basically what OWB is, it's relationship
to JSR-299 etc. Maybe call it something else. *Further configuration* is
stuff like failover.
*Using OpenWebBeans*
• Getting started
• OWB explained
• Further configuration
• OWB Samples
*Modules*
• Modules Overview Page
*OpenWebBeans CDI testing framework*
• CDI Test Framework
Suggestion 2:
Basically here Getting started is promoted to a bigger text to be more
recognizable. After all, it's the link most visitors want in the first
place.
*About OpenWebBeans*
• General information / OWB explained
*Getting started with OpenWebBeans*
• Getting started
• Further configuration
• OWB Samples
*Modules*
• Modules Overview Page
*OpenWebBeans CDI testing framework*
• CDI Test Framework
cheers
Re: Documentation layout suggestions
Posted by Karl Kildén <ka...@gmail.com>.
Since everyone liked suggestion #2 we skip the other one.
http://notepag.es/bwXRZ1
Here's an outline of the second one
On 1 October 2013 21:41, Thomas Andraschko <an...@gmail.com>wrote:
> sorry, i mean subpage - not subpoint
>
>
> 2013/10/1 Thomas Andraschko <an...@gmail.com>
>
> > I mean this points:
> >
> > *OpenWebBeans CDI testing framework*
> >
> > • CDI Test Framework
> >
> >
> > Isn' it exactly the same? It the second point a subpoint or what does it
> > mean?
> >
> >
> > 2013/10/1 Karl Kildén <ka...@gmail.com>
> >
> >> Thomas, exactly what would you prefer merged and after you reply; can
> you
> >> others comment on that as well? Thank you.
> >>
> >> Might as well try to get it kinda right the first time even though we
> can
> >> update the layout over time ;-)
> >>
> >>
> >> On 1 October 2013 21:14, Thomas Andraschko <andraschko.thomas@gmail.com
> >> >wrote:
> >>
> >> > +1 for the second
> >> >
> >> > I would only merge the last two points
> >> >
> >> >
> >> > 2013/10/1 Gerhard Petracek <ge...@gmail.com>
> >> >
> >> > > +1
> >> > >
> >> > > regards,
> >> > > gerhard
> >> > >
> >> > >
> >> > >
> >> > > 2013/10/1 Arne Limburg <ar...@openknowledge.de>
> >> > >
> >> > > > +1 for the second suggestion
> >> > > > I like the "Getting Started" part to be promoted bigger
> >> > > >
> >> > > >
> >> > > >
> >> > > > Am 01.10.13 20:54 schrieb "Karl Kildén" unter <
> >> karl.kilden@gmail.com>:
> >> > > >
> >> > > > >First things first. We really need to finish the "getting
> started"
> >> > part.
> >> > > > >Getting started with OWB is not even that much information to
> >> > condense.
> >> > > > >While I start with that, please give your input to the
> >> documentation
> >> > > > >layout. This is basically what you should see when you click
> >> > > > >"Documentation". Me and Mark discussed it for 2 minutes and have
> >> two
> >> > > basic
> >> > > > >(and very similar) suggestions. Wdyt?
> >> > > > >
> >> > > > > Suggestion 1:
> >> > > > >
> >> > > > >Second link "*OWB explained*" is basically what OWB is, it's
> >> > > relationship
> >> > > > >to JSR-299 etc. Maybe call it something else. *Further
> >> configuration*
> >> > is
> >> > > > >stuff like failover.
> >> > > > >
> >> > > > >*Using OpenWebBeans*
> >> > > > >
> >> > > > >€ Getting started
> >> > > > >
> >> > > > >€ OWB explained
> >> > > > >
> >> > > > >€ Further configuration
> >> > > > >
> >> > > > >€ OWB Samples
> >> > > > >
> >> > > > >*Modules*
> >> > > > >
> >> > > > >€ Modules Overview Page
> >> > > > >
> >> > > > >*OpenWebBeans CDI testing framework*
> >> > > > >
> >> > > > >€ CDI Test Framework
> >> > > > >
> >> > > > >
> >> > > > > Suggestion 2:
> >> > > > >Basically here Getting started is promoted to a bigger text to be
> >> more
> >> > > > >recognizable. After all, it's the link most visitors want in the
> >> first
> >> > > > >place.
> >> > > > >
> >> > > > >*About OpenWebBeans*
> >> > > > >
> >> > > > >€ General information / OWB explained
> >> > > > >
> >> > > > >*Getting started with OpenWebBeans*
> >> > > > >
> >> > > > >€ Getting started
> >> > > > >
> >> > > > >€ Further configuration
> >> > > > >
> >> > > > >€ OWB Samples
> >> > > > >
> >> > > > >*Modules*
> >> > > > >
> >> > > > >€ Modules Overview Page
> >> > > > >
> >> > > > >*OpenWebBeans CDI testing framework*
> >> > > > >
> >> > > > >€ CDI Test Framework
> >> > > > >cheers
> >> > > >
> >> > > >
> >> > >
> >> >
> >>
> >
> >
>
Re: Documentation layout suggestions
Posted by Thomas Andraschko <an...@gmail.com>.
sorry, i mean subpage - not subpoint
2013/10/1 Thomas Andraschko <an...@gmail.com>
> I mean this points:
>
> *OpenWebBeans CDI testing framework*
>
> • CDI Test Framework
>
>
> Isn' it exactly the same? It the second point a subpoint or what does it
> mean?
>
>
> 2013/10/1 Karl Kildén <ka...@gmail.com>
>
>> Thomas, exactly what would you prefer merged and after you reply; can you
>> others comment on that as well? Thank you.
>>
>> Might as well try to get it kinda right the first time even though we can
>> update the layout over time ;-)
>>
>>
>> On 1 October 2013 21:14, Thomas Andraschko <andraschko.thomas@gmail.com
>> >wrote:
>>
>> > +1 for the second
>> >
>> > I would only merge the last two points
>> >
>> >
>> > 2013/10/1 Gerhard Petracek <ge...@gmail.com>
>> >
>> > > +1
>> > >
>> > > regards,
>> > > gerhard
>> > >
>> > >
>> > >
>> > > 2013/10/1 Arne Limburg <ar...@openknowledge.de>
>> > >
>> > > > +1 for the second suggestion
>> > > > I like the "Getting Started" part to be promoted bigger
>> > > >
>> > > >
>> > > >
>> > > > Am 01.10.13 20:54 schrieb "Karl Kildén" unter <
>> karl.kilden@gmail.com>:
>> > > >
>> > > > >First things first. We really need to finish the "getting started"
>> > part.
>> > > > >Getting started with OWB is not even that much information to
>> > condense.
>> > > > >While I start with that, please give your input to the
>> documentation
>> > > > >layout. This is basically what you should see when you click
>> > > > >"Documentation". Me and Mark discussed it for 2 minutes and have
>> two
>> > > basic
>> > > > >(and very similar) suggestions. Wdyt?
>> > > > >
>> > > > > Suggestion 1:
>> > > > >
>> > > > >Second link "*OWB explained*" is basically what OWB is, it's
>> > > relationship
>> > > > >to JSR-299 etc. Maybe call it something else. *Further
>> configuration*
>> > is
>> > > > >stuff like failover.
>> > > > >
>> > > > >*Using OpenWebBeans*
>> > > > >
>> > > > >€ Getting started
>> > > > >
>> > > > >€ OWB explained
>> > > > >
>> > > > >€ Further configuration
>> > > > >
>> > > > >€ OWB Samples
>> > > > >
>> > > > >*Modules*
>> > > > >
>> > > > >€ Modules Overview Page
>> > > > >
>> > > > >*OpenWebBeans CDI testing framework*
>> > > > >
>> > > > >€ CDI Test Framework
>> > > > >
>> > > > >
>> > > > > Suggestion 2:
>> > > > >Basically here Getting started is promoted to a bigger text to be
>> more
>> > > > >recognizable. After all, it's the link most visitors want in the
>> first
>> > > > >place.
>> > > > >
>> > > > >*About OpenWebBeans*
>> > > > >
>> > > > >€ General information / OWB explained
>> > > > >
>> > > > >*Getting started with OpenWebBeans*
>> > > > >
>> > > > >€ Getting started
>> > > > >
>> > > > >€ Further configuration
>> > > > >
>> > > > >€ OWB Samples
>> > > > >
>> > > > >*Modules*
>> > > > >
>> > > > >€ Modules Overview Page
>> > > > >
>> > > > >*OpenWebBeans CDI testing framework*
>> > > > >
>> > > > >€ CDI Test Framework
>> > > > >cheers
>> > > >
>> > > >
>> > >
>> >
>>
>
>
Re: Documentation layout suggestions
Posted by Thomas Andraschko <an...@gmail.com>.
I mean this points:
*OpenWebBeans CDI testing framework*
• CDI Test Framework
Isn' it exactly the same? It the second point a subpoint or what does it
mean?
2013/10/1 Karl Kildén <ka...@gmail.com>
> Thomas, exactly what would you prefer merged and after you reply; can you
> others comment on that as well? Thank you.
>
> Might as well try to get it kinda right the first time even though we can
> update the layout over time ;-)
>
>
> On 1 October 2013 21:14, Thomas Andraschko <andraschko.thomas@gmail.com
> >wrote:
>
> > +1 for the second
> >
> > I would only merge the last two points
> >
> >
> > 2013/10/1 Gerhard Petracek <ge...@gmail.com>
> >
> > > +1
> > >
> > > regards,
> > > gerhard
> > >
> > >
> > >
> > > 2013/10/1 Arne Limburg <ar...@openknowledge.de>
> > >
> > > > +1 for the second suggestion
> > > > I like the "Getting Started" part to be promoted bigger
> > > >
> > > >
> > > >
> > > > Am 01.10.13 20:54 schrieb "Karl Kildén" unter <karl.kilden@gmail.com
> >:
> > > >
> > > > >First things first. We really need to finish the "getting started"
> > part.
> > > > >Getting started with OWB is not even that much information to
> > condense.
> > > > >While I start with that, please give your input to the documentation
> > > > >layout. This is basically what you should see when you click
> > > > >"Documentation". Me and Mark discussed it for 2 minutes and have two
> > > basic
> > > > >(and very similar) suggestions. Wdyt?
> > > > >
> > > > > Suggestion 1:
> > > > >
> > > > >Second link "*OWB explained*" is basically what OWB is, it's
> > > relationship
> > > > >to JSR-299 etc. Maybe call it something else. *Further
> configuration*
> > is
> > > > >stuff like failover.
> > > > >
> > > > >*Using OpenWebBeans*
> > > > >
> > > > >€ Getting started
> > > > >
> > > > >€ OWB explained
> > > > >
> > > > >€ Further configuration
> > > > >
> > > > >€ OWB Samples
> > > > >
> > > > >*Modules*
> > > > >
> > > > >€ Modules Overview Page
> > > > >
> > > > >*OpenWebBeans CDI testing framework*
> > > > >
> > > > >€ CDI Test Framework
> > > > >
> > > > >
> > > > > Suggestion 2:
> > > > >Basically here Getting started is promoted to a bigger text to be
> more
> > > > >recognizable. After all, it's the link most visitors want in the
> first
> > > > >place.
> > > > >
> > > > >*About OpenWebBeans*
> > > > >
> > > > >€ General information / OWB explained
> > > > >
> > > > >*Getting started with OpenWebBeans*
> > > > >
> > > > >€ Getting started
> > > > >
> > > > >€ Further configuration
> > > > >
> > > > >€ OWB Samples
> > > > >
> > > > >*Modules*
> > > > >
> > > > >€ Modules Overview Page
> > > > >
> > > > >*OpenWebBeans CDI testing framework*
> > > > >
> > > > >€ CDI Test Framework
> > > > >cheers
> > > >
> > > >
> > >
> >
>
Re: Documentation layout suggestions
Posted by Karl Kildén <ka...@gmail.com>.
Thomas, exactly what would you prefer merged and after you reply; can you
others comment on that as well? Thank you.
Might as well try to get it kinda right the first time even though we can
update the layout over time ;-)
On 1 October 2013 21:14, Thomas Andraschko <an...@gmail.com>wrote:
> +1 for the second
>
> I would only merge the last two points
>
>
> 2013/10/1 Gerhard Petracek <ge...@gmail.com>
>
> > +1
> >
> > regards,
> > gerhard
> >
> >
> >
> > 2013/10/1 Arne Limburg <ar...@openknowledge.de>
> >
> > > +1 for the second suggestion
> > > I like the "Getting Started" part to be promoted bigger
> > >
> > >
> > >
> > > Am 01.10.13 20:54 schrieb "Karl Kildén" unter <ka...@gmail.com>:
> > >
> > > >First things first. We really need to finish the "getting started"
> part.
> > > >Getting started with OWB is not even that much information to
> condense.
> > > >While I start with that, please give your input to the documentation
> > > >layout. This is basically what you should see when you click
> > > >"Documentation". Me and Mark discussed it for 2 minutes and have two
> > basic
> > > >(and very similar) suggestions. Wdyt?
> > > >
> > > > Suggestion 1:
> > > >
> > > >Second link "*OWB explained*" is basically what OWB is, it's
> > relationship
> > > >to JSR-299 etc. Maybe call it something else. *Further configuration*
> is
> > > >stuff like failover.
> > > >
> > > >*Using OpenWebBeans*
> > > >
> > > >€ Getting started
> > > >
> > > >€ OWB explained
> > > >
> > > >€ Further configuration
> > > >
> > > >€ OWB Samples
> > > >
> > > >*Modules*
> > > >
> > > >€ Modules Overview Page
> > > >
> > > >*OpenWebBeans CDI testing framework*
> > > >
> > > >€ CDI Test Framework
> > > >
> > > >
> > > > Suggestion 2:
> > > >Basically here Getting started is promoted to a bigger text to be more
> > > >recognizable. After all, it's the link most visitors want in the first
> > > >place.
> > > >
> > > >*About OpenWebBeans*
> > > >
> > > >€ General information / OWB explained
> > > >
> > > >*Getting started with OpenWebBeans*
> > > >
> > > >€ Getting started
> > > >
> > > >€ Further configuration
> > > >
> > > >€ OWB Samples
> > > >
> > > >*Modules*
> > > >
> > > >€ Modules Overview Page
> > > >
> > > >*OpenWebBeans CDI testing framework*
> > > >
> > > >€ CDI Test Framework
> > > >cheers
> > >
> > >
> >
>
Re: Documentation layout suggestions
Posted by Thomas Andraschko <an...@gmail.com>.
+1 for the second
I would only merge the last two points
2013/10/1 Gerhard Petracek <ge...@gmail.com>
> +1
>
> regards,
> gerhard
>
>
>
> 2013/10/1 Arne Limburg <ar...@openknowledge.de>
>
> > +1 for the second suggestion
> > I like the "Getting Started" part to be promoted bigger
> >
> >
> >
> > Am 01.10.13 20:54 schrieb "Karl Kildén" unter <ka...@gmail.com>:
> >
> > >First things first. We really need to finish the "getting started" part.
> > >Getting started with OWB is not even that much information to condense.
> > >While I start with that, please give your input to the documentation
> > >layout. This is basically what you should see when you click
> > >"Documentation". Me and Mark discussed it for 2 minutes and have two
> basic
> > >(and very similar) suggestions. Wdyt?
> > >
> > > Suggestion 1:
> > >
> > >Second link "*OWB explained*" is basically what OWB is, it's
> relationship
> > >to JSR-299 etc. Maybe call it something else. *Further configuration* is
> > >stuff like failover.
> > >
> > >*Using OpenWebBeans*
> > >
> > >€ Getting started
> > >
> > >€ OWB explained
> > >
> > >€ Further configuration
> > >
> > >€ OWB Samples
> > >
> > >*Modules*
> > >
> > >€ Modules Overview Page
> > >
> > >*OpenWebBeans CDI testing framework*
> > >
> > >€ CDI Test Framework
> > >
> > >
> > > Suggestion 2:
> > >Basically here Getting started is promoted to a bigger text to be more
> > >recognizable. After all, it's the link most visitors want in the first
> > >place.
> > >
> > >*About OpenWebBeans*
> > >
> > >€ General information / OWB explained
> > >
> > >*Getting started with OpenWebBeans*
> > >
> > >€ Getting started
> > >
> > >€ Further configuration
> > >
> > >€ OWB Samples
> > >
> > >*Modules*
> > >
> > >€ Modules Overview Page
> > >
> > >*OpenWebBeans CDI testing framework*
> > >
> > >€ CDI Test Framework
> > >cheers
> >
> >
>
Re: Documentation layout suggestions
Posted by Mark Struberg <st...@yahoo.de>.
+1 for 2nd as well.
LieGrue,
strub
----- Original Message -----
> From: Gerhard Petracek <ge...@gmail.com>
> To: openwebbeans-dev <de...@openwebbeans.apache.org>
> Cc:
> Sent: Tuesday, 1 October 2013, 20:59
> Subject: Re: Documentation layout suggestions
>
> +1
>
> regards,
> gerhard
>
>
>
> 2013/10/1 Arne Limburg <ar...@openknowledge.de>
>
>> +1 for the second suggestion
>> I like the "Getting Started" part to be promoted bigger
>>
>>
>>
>> Am 01.10.13 20:54 schrieb "Karl Kildén" unter
> <ka...@gmail.com>:
>>
>> >First things first. We really need to finish the "getting
> started" part.
>> >Getting started with OWB is not even that much information to condense.
>> >While I start with that, please give your input to the documentation
>> >layout. This is basically what you should see when you click
>> >"Documentation". Me and Mark discussed it for 2 minutes and
> have two basic
>> >(and very similar) suggestions. Wdyt?
>> >
>> > Suggestion 1:
>> >
>> >Second link "*OWB explained*" is basically what OWB is,
> it's relationship
>> >to JSR-299 etc. Maybe call it something else. *Further configuration*
> is
>> >stuff like failover.
>> >
>> >*Using OpenWebBeans*
>> >
>> >€ Getting started
>> >
>> >€ OWB explained
>> >
>> >€ Further configuration
>> >
>> >€ OWB Samples
>> >
>> >*Modules*
>> >
>> >€ Modules Overview Page
>> >
>> >*OpenWebBeans CDI testing framework*
>> >
>> >€ CDI Test Framework
>> >
>> >
>> > Suggestion 2:
>> >Basically here Getting started is promoted to a bigger text to be more
>> >recognizable. After all, it's the link most visitors want in the
> first
>> >place.
>> >
>> >*About OpenWebBeans*
>> >
>> >€ General information / OWB explained
>> >
>> >*Getting started with OpenWebBeans*
>> >
>> >€ Getting started
>> >
>> >€ Further configuration
>> >
>> >€ OWB Samples
>> >
>> >*Modules*
>> >
>> >€ Modules Overview Page
>> >
>> >*OpenWebBeans CDI testing framework*
>> >
>> >€ CDI Test Framework
>> >cheers
>>
>>
>
Re: Documentation layout suggestions
Posted by Gerhard Petracek <ge...@gmail.com>.
+1
regards,
gerhard
2013/10/1 Arne Limburg <ar...@openknowledge.de>
> +1 for the second suggestion
> I like the "Getting Started" part to be promoted bigger
>
>
>
> Am 01.10.13 20:54 schrieb "Karl Kildén" unter <ka...@gmail.com>:
>
> >First things first. We really need to finish the "getting started" part.
> >Getting started with OWB is not even that much information to condense.
> >While I start with that, please give your input to the documentation
> >layout. This is basically what you should see when you click
> >"Documentation". Me and Mark discussed it for 2 minutes and have two basic
> >(and very similar) suggestions. Wdyt?
> >
> > Suggestion 1:
> >
> >Second link "*OWB explained*" is basically what OWB is, it's relationship
> >to JSR-299 etc. Maybe call it something else. *Further configuration* is
> >stuff like failover.
> >
> >*Using OpenWebBeans*
> >
> >€ Getting started
> >
> >€ OWB explained
> >
> >€ Further configuration
> >
> >€ OWB Samples
> >
> >*Modules*
> >
> >€ Modules Overview Page
> >
> >*OpenWebBeans CDI testing framework*
> >
> >€ CDI Test Framework
> >
> >
> > Suggestion 2:
> >Basically here Getting started is promoted to a bigger text to be more
> >recognizable. After all, it's the link most visitors want in the first
> >place.
> >
> >*About OpenWebBeans*
> >
> >€ General information / OWB explained
> >
> >*Getting started with OpenWebBeans*
> >
> >€ Getting started
> >
> >€ Further configuration
> >
> >€ OWB Samples
> >
> >*Modules*
> >
> >€ Modules Overview Page
> >
> >*OpenWebBeans CDI testing framework*
> >
> >€ CDI Test Framework
> >cheers
>
>
Re: Documentation layout suggestions
Posted by Arne Limburg <ar...@openknowledge.de>.
+1 for the second suggestion
I like the "Getting Started" part to be promoted bigger
Am 01.10.13 20:54 schrieb "Karl Kildén" unter <ka...@gmail.com>:
>First things first. We really need to finish the "getting started" part.
>Getting started with OWB is not even that much information to condense.
>While I start with that, please give your input to the documentation
>layout. This is basically what you should see when you click
>"Documentation". Me and Mark discussed it for 2 minutes and have two basic
>(and very similar) suggestions. Wdyt?
>
> Suggestion 1:
>
>Second link "*OWB explained*" is basically what OWB is, it's relationship
>to JSR-299 etc. Maybe call it something else. *Further configuration* is
>stuff like failover.
>
>*Using OpenWebBeans*
>
>€ Getting started
>
>€ OWB explained
>
>€ Further configuration
>
>€ OWB Samples
>
>*Modules*
>
>€ Modules Overview Page
>
>*OpenWebBeans CDI testing framework*
>
>€ CDI Test Framework
>
>
> Suggestion 2:
>Basically here Getting started is promoted to a bigger text to be more
>recognizable. After all, it's the link most visitors want in the first
>place.
>
>*About OpenWebBeans*
>
>€ General information / OWB explained
>
>*Getting started with OpenWebBeans*
>
>€ Getting started
>
>€ Further configuration
>
>€ OWB Samples
>
>*Modules*
>
>€ Modules Overview Page
>
>*OpenWebBeans CDI testing framework*
>
>€ CDI Test Framework
>cheers