Forrest site

[Aidan Skinner <ai...@apache.org>]

Hi,

I managed to find some time this evening to sort out the forrest demo
that we've been talking about. Check it out at
http://aidan.skinner.me.uk/qpid/

It's still based off an old export of the confluence site, which needs
updating, and the visual look is a bit defaulty...

- Aidan

-- 
aim/y!:aidans42 g:aidan.skinner@gmail.com
http://aidan.skinner.me.uk/
"We belong to nobody and nobody belongs to us. We don't even belong to
each other."

Re: Forrest site

[Aidan Skinner <ai...@apache.org>]

On Tue, Jun 17, 2008 at 9:00 AM, Marnie McCormack
<ma...@googlemail.com> wrote:

> Has there been a discussion about how we restructure from the Java/C++ pov
> at all (apologies if I've missed it) ? So, currently there are n paths
> through the docs, one per implementation (more or less). Are we going to
> keep this distinction - i think it's useful.If not, then I guesswe need to
> rename our docs once exported to make their applicability clearer.

There was some discussion about this, I believe Johnathon and Danushka
are going to mind map it out. We also talked about splitting it into
About (Overview, FAQ etc.), Developers (API, Programming Tutorials...)
and Users (Downloads, Installation, Management type stuff) sections so
that it flows better.

> I'd also propose (and I'll try to make Thursday's call) that we review the
> docs we have before we get too much further.

My main task at the moment with docs is doing that so I can start
getting a grip on the confluence export I took on Friday and making
sure that's all navigable.

- Aidan
-- 
aim/y!:aidans42 g:aidan.skinner@gmail.com
http://aidan.skinner.me.uk/
"We belong to nobody and nobody belongs to us. We don't even belong to
each other."

Re: Forrest site

[Marnie McCormack <ma...@googlemail.com>]

Hi Aidan,

Just been having a quick look.

Has there been a discussion about how we restructure from the Java/C++ pov
at all (apologies if I've missed it) ? So, currently there are n paths
through the docs, one per implementation (more or less). Are we going to
keep this distinction - i think it's useful.If not, then I guesswe need to
rename our docs once exported to make their applicability clearer.

I'd also propose (and I'll try to make Thursday's call) that we review the
docs we have before we get too much further.

Thoughts ?

Bfn,
Marnie




On 6/11/08, Aidan Skinner <ai...@apache.org> wrote:
>
> On Tue, Jun 10, 2008 at 1:53 PM, Jonathan Robie
> <jo...@redhat.com> wrote:
>
> > I think getting some of the new materials up is a high priority - Senaka
> has
> > written some really useful documentation, and I think the tutorials Red
> Hat
> > donated are also useful. Can the work be distributed somehow so more than
> > one person can work on the site, and we can divide up responsibilities
> and
> > work in parallel?
>
> Yeah, the first step is probably to re-export from confluence and add
> in the new material to the navigation in
> src/documentation/content/xdocs/site.xml
>
> > Does Forrest allow the same level of access as the Wiki? How will people
> > make changes? What features are there for reviewing changes?  Could we
> use
> > part of the meeting on Monday to discuss how we get what materials up?
>
> It's easier to get an account to edit, since you only need
> comittership (not comittership+confluence bit). Changes are checked
> into svn, and could be reviewed as part of the code review process
> (ie. qpid-commits and the meetings).
>
> > What timing would you suggest for having this up and running publicly?
>
> ASAP, although I'm currently very limited in what time I can devote to
> this. I'd like to aim for end of the month, but I don't know how
> realistic that is given my other comittments atm.
>
> - Aidan
> --
> aim/y!:aidans42 g:aidan.skinner@gmail.com <g%...@gmail.com>
> http://aidan.skinner.me.uk/
> "We belong to nobody and nobody belongs to us. We don't even belong to
> each other."
>

Re: Forrest site

[Aidan Skinner <ai...@apache.org>]

On Tue, Jun 10, 2008 at 1:53 PM, Jonathan Robie
<jo...@redhat.com> wrote:

> I think getting some of the new materials up is a high priority - Senaka has
> written some really useful documentation, and I think the tutorials Red Hat
> donated are also useful. Can the work be distributed somehow so more than
> one person can work on the site, and we can divide up responsibilities and
> work in parallel?

Yeah, the first step is probably to re-export from confluence and add
in the new material to the navigation in
src/documentation/content/xdocs/site.xml

> Does Forrest allow the same level of access as the Wiki? How will people
> make changes? What features are there for reviewing changes?  Could we use
> part of the meeting on Monday to discuss how we get what materials up?

It's easier to get an account to edit, since you only need
comittership (not comittership+confluence bit). Changes are checked
into svn, and could be reviewed as part of the code review process
(ie. qpid-commits and the meetings).

> What timing would you suggest for having this up and running publicly?

ASAP, although I'm currently very limited in what time I can devote to
this. I'd like to aim for end of the month, but I don't know how
realistic that is given my other comittments atm.

- Aidan
-- 
aim/y!:aidans42 g:aidan.skinner@gmail.com
http://aidan.skinner.me.uk/
"We belong to nobody and nobody belongs to us. We don't even belong to
each other."

Re: Forrest site

[Jonathan Robie <jo...@redhat.com>]

Aidan Skinner wrote:
> On Sun, Jun 1, 2008 at 10:35 PM, Danushka Menikkumbura
> <da...@wso2.com> wrote:
>
>   
>>   Why don't we have a plan on what needs to be done next?. May be brushing
>> up the visual look?.
>>     
>
> It needs retheming, but I think resyncing with the current site is
> probably a higher priority - that export predates carls'
> reorganisation for instance.
>   

The site definitely looks good.

I think getting some of the new materials up is a high priority - Senaka 
has written some really useful documentation, and I think the tutorials 
Red Hat donated are also useful. Can the work be distributed somehow so 
more than one person can work on the site, and we can divide up 
responsibilities and work in parallel?

Does Forrest allow the same level of access as the Wiki? How will people 
make changes? What features are there for reviewing changes?  Could we 
use part of the meeting on Monday to discuss how we get what materials up?

What timing would you suggest for having this up and running publicly?

Jonathan

Re: Forrest site

[Aidan Skinner <ai...@apache.org>]

On Mon, Jun 2, 2008 at 1:54 PM, Carl Trieloff <cc...@redhat.com> wrote:

> Had a brief look. it looks like only the one brokers info is navigated from
> the left hand side menu, I
> guess this is because it is from the old export of confluence, however once
> you have generated one
> of a new export we might want to also better organize the layout. And yes,

It's totally a work in progress atm.

> it is going to need some
> art etc :-)

It really, really does. I am not the person to look too on that front though ;)

> BTW, what is involved in editing the site?

It's dead easy, first install forrest from
http://forrest.apache.org/mirrors.cgi untar it and set FORREST_HOME to
it's location, and add $FORREST_HOME/bin to $PATH

Then svn co https://svn.apache.org/repos/asf/incubator/qpid/branches/forrest-site/
and run 'forrest run' to start the built in jetty server, which you
can view at localhost:8888. I prefer that way for actually working on
it since it reflects updates. You can also use the site target to
generate a static html version, which is what I uploaded.

(those of you who had checkouts of this previously, sorry, I busted you)

- Aidan
-- 
aim/y!:aidans42 g:aidan.skinner@gmail.com
http://aidan.skinner.me.uk/
"We belong to nobody and nobody belongs to us. We don't even belong to
each other."

Re: Forrest site

[Carl Trieloff <cc...@redhat.com>]

Aidan Skinner wrote:
> On Sun, Jun 1, 2008 at 10:35 PM, Danushka Menikkumbura
> <da...@wso2.com> wrote:
>
>   
>>   Why don't we have a plan on what needs to be done next?. May be brushing
>> up the visual look?.
>>     
>
> It needs retheming, but I think resyncing with the current site is
> probably a higher priority - that export predates carls'
> reorganisation for instance.
>
> - Aidan
>   

Aidan,

Had a brief look. it looks like only the one brokers info is navigated 
from the left hand side menu, I
guess this is because it is from the old export of confluence, however 
once you have generated one
of a new export we might want to also better organize the layout. And 
yes, it is going to need some
art etc :-) 

nice start-- I like the way the navigation work.

BTW, what is involved in editing the site?
Carl.

Re: Forrest site

[Aidan Skinner <ai...@apache.org>]

On Sun, Jun 1, 2008 at 10:35 PM, Danushka Menikkumbura
<da...@wso2.com> wrote:

>   Why don't we have a plan on what needs to be done next?. May be brushing
> up the visual look?.

It needs retheming, but I think resyncing with the current site is
probably a higher priority - that export predates carls'
reorganisation for instance.

- Aidan
-- 
aim/y!:aidans42 g:aidan.skinner@gmail.com
http://aidan.skinner.me.uk/
"We belong to nobody and nobody belongs to us. We don't even belong to
each other."

Re: Forrest site

[Danushka Menikkumbura <da...@wso2.com>]

Hi Aidan,
    Why don't we have a plan on what needs to be done next?. May be 
brushing up the visual look?.

Danushka

Aidan Skinner wrote:
> Hi,
>
> I managed to find some time this evening to sort out the forrest demo
> that we've been talking about. Check it out at
> http://aidan.skinner.me.uk/qpid/
>
> It's still based off an old export of the confluence site, which needs
> updating, and the visual look is a bit defaulty...
>
> - Aidan
>
>