You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Reinhard Poetz <re...@apache.org> on 2007/03/20 12:02:41 UTC
Publishing our new docs - what else needs to be done?
Jeroen Reijn wrote:
> *Applause*
>
> Great work! :D
>
> So when are we going to put this live?
there is some work left:
- create a Maven skin (-> writing a Velocity template)
- initial content for
http://cocoon.apache.org and
--> http://cocoon.zones.apache.org/daisy/cdocs-site-main/g1/1285.html
http://cocoon.apache.org/2.2/
--> I will create a Daisy site ASAP
Probably there are some more things to do left - I will create a (more detailed)
todo list this evening or tommorrow and share it with this list.
Any help would be highly appreciated!!!!
--
Reinhard
Re: [graphics] Re: Publishing our new docs - what else needs to be
done?
Posted by Joerg Heinicke <jo...@gmx.de>.
On 20.03.2007 13:30, Ross McDonald wrote:
> The new site looks excellent.. can't wait till its live, thanks!
+1 I completely agree. Thanks, Thien.
Jörg
Re: [graphics] Re: Publishing our new docs - what else needs to be done?
Posted by Ross McDonald <ro...@yahoo.co.uk>.
The new site looks excellent.. can't wait till its live, thanks!
Ross
On 20 Mar 2007, at 12:08, hepabolu wrote:
> Reinhard Poetz said the following on 20/3/07 12:02:
>> Jeroen Reijn wrote:
>>> *Applause*
>>>
>>> Great work! :D
>>>
>>> So when are we going to put this live?
>> there is some work left:
>> - create a Maven skin (-> writing a Velocity template)
>> - initial content for
>> http://cocoon.apache.org and
>> --> http://cocoon.zones.apache.org/daisy/cdocs-site-main/
>> g1/1285.html
>> http://cocoon.apache.org/2.2/
>> --> I will create a Daisy site ASAP
>
> Isn't this simply the current 'one site per block' setup? Or, the
> 'stuff' you put up at http://cocoon.zones.apache.org/dev-docs/?
>
> I'm getting confused about the purpose of all these different sites/
> collections.
>
> I'm not sure if you have shed some light on this somewhere, but
> here's my idea (at least that's what I assume it is):
> - 'legacydocs' is the 'old' documentation -> now exported as Cocoon
> 2.1 docs
> - 'one site/collection per block' is the documentation for Cocoon 2.2
>
>> Probably there are some more things to do left - I will create a
>> (more detailed) todo list this evening or tommorrow and share it
>> with this list.
>> Any help would be highly appreciated!!!!
>
> I'll review your list and add things when necessary.
>
> There are a few things left to do that probably need Thien's
> expertise. This page is the home page and it typically has a
> different layout than the other pages. E.g. the majority of the
> pages will consist of a left menu column and a wide content column.
> I wonder if that is not going to be too wide to read comfortably,
> or we should now agree that most people use their browser at a
> size more or less equal to 1024 x 768 or less.
>
> We also need some more styling elements:
> - tables
> - warning
> - FIXME/TO DO
>
> Bye, Helma
___________________________________________________________
Try the all-new Yahoo! Mail. "The New Version is radically easier to use" � The Wall Street Journal
http://uk.docs.yahoo.com/nowyoucan.html
Re: [graphics] Re: Publishing our new docs - what else needs to be
done?
Posted by Reinhard Poetz <re...@apache.org>.
hepabolu wrote:
> Reinhard Poetz said the following on 29/3/07 00:17:
>> Sorry for picking up this thread again after more than a week. My
>> apologies.
>
> No worries.
>
>> See http://cocoon.zones.apache.org/daisy/cdocs/g4/1346.html. As I
>> don't want to create dozens of JIRA tasks, I created this list. As the
>> handling of huge tables is more comfortable in Daisy than in our Wiki,
>> I created it in Daisy.
>
> Fine by me, I've added myself to do some tasks.
great!
I only moved some of the "sub documentations" to the third part of the
documentation because we haven't released any milestone from them yet. That
doesn't mean that nobdoy is allowed to work on them. It should show that from a
general perspective there would be more important tasks getting done.
--
Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc
--------------------------------------------------------------------
Re: [graphics] Re: Publishing our new docs - what else needs to be
done?
Posted by hepabolu <he...@gmail.com>.
Reinhard Poetz said the following on 29/3/07 00:17:
> Sorry for picking up this thread again after more than a week. My
> apologies.
No worries.
> See http://cocoon.zones.apache.org/daisy/cdocs/g4/1346.html. As I don't
> want to create dozens of JIRA tasks, I created this list. As the
> handling of huge tables is more comfortable in Daisy than in our Wiki, I
> created it in Daisy.
Fine by me, I've added myself to do some tasks.
Bye, Helma
Re: [graphics] Re: Publishing our new docs - what else needs to be
done?
Posted by Reinhard Poetz <re...@apache.org>.
Sorry for picking up this thread again after more than a week. My apologies.
hepabolu wrote:
> Reinhard Poetz said the following on 20/3/07 12:02:
>> Jeroen Reijn wrote:
>>> *Applause*
>>>
>>> Great work! :D
>>>
>>> So when are we going to put this live?
>>
>> there is some work left:
>>
>> - create a Maven skin (-> writing a Velocity template)
>> - initial content for
>> http://cocoon.apache.org and
>> -->
>> http://cocoon.zones.apache.org/daisy/cdocs-site-main/g1/1285.html
>> http://cocoon.apache.org/2.2/
>> --> I will create a Daisy site ASAP
>
> Isn't this simply the current 'one site per block' setup? Or, the
> 'stuff' you put up at http://cocoon.zones.apache.org/dev-docs/?
>
> I'm getting confused about the purpose of all these different
> sites/collections.
>
> I'm not sure if you have shed some light on this somewhere, but here's
> my idea (at least that's what I assume it is):
> - 'legacydocs' is the 'old' documentation -> now exported as Cocoon 2.1
> docs
> - 'one site/collection per block' is the documentation for Cocoon 2.2
Right, each "module" (a block, a core module or a Maven plugin) gets its own
documentation that can stand for itself. This requires 4 things:
- a Daisy site
- a navigation document that is refered to from the site configuration
- an index documentation that is refered to from the site configuration
- a Maven plugin documentation
Additionally we have some documentation-only modules. See cocoon/trunk/site.
That's necessary for all the documentation that comes without code (e.g. the PMC
site, the 2.2 site, the interstitial sites to get an overview of all blocks,
core modules, Maven plugins and sub-projects)
Everything "old" is marked as deprecated at the Daisy sites overview pages
(http://cocoon.zones.apache.org/daisy/).
>> Probably there are some more things to do left - I will create a (more
>> detailed) todo list this evening or tommorrow and share it with this
>> list.
>>
>> Any help would be highly appreciated!!!!
>
> I'll review your list and add things when necessary.
See http://cocoon.zones.apache.org/daisy/cdocs/g4/1346.html. As I don't want to
create dozens of JIRA tasks, I created this list. As the handling of huge tables
is more comfortable in Daisy than in our Wiki, I created it in Daisy.
>
> There are a few things left to do that probably need Thien's expertise.
> This page is the home page and it typically has a different layout than
> the other pages. E.g. the majority of the pages will consist of a left
> menu column and a wide content column. I wonder if that is not going to
> be too wide to read comfortably, or we should now agree that most people
> use their browser at a size more or less equal to 1024 x 768 or less.
> We also need some more styling elements:
> - tables
> - warning
> - FIXME/TO DO
I added a task to the list.
--
Reinhard Pötz Independent Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc
--------------------------------------------------------------------
[graphics] Re: Publishing our new docs - what else needs to be done?
Posted by hepabolu <he...@gmail.com>.
Reinhard Poetz said the following on 20/3/07 12:02:
> Jeroen Reijn wrote:
>> *Applause*
>>
>> Great work! :D
>>
>> So when are we going to put this live?
>
> there is some work left:
>
> - create a Maven skin (-> writing a Velocity template)
> - initial content for
> http://cocoon.apache.org and
> --> http://cocoon.zones.apache.org/daisy/cdocs-site-main/g1/1285.html
> http://cocoon.apache.org/2.2/
> --> I will create a Daisy site ASAP
Isn't this simply the current 'one site per block' setup? Or, the
'stuff' you put up at http://cocoon.zones.apache.org/dev-docs/?
I'm getting confused about the purpose of all these different
sites/collections.
I'm not sure if you have shed some light on this somewhere, but here's
my idea (at least that's what I assume it is):
- 'legacydocs' is the 'old' documentation -> now exported as Cocoon 2.1 docs
- 'one site/collection per block' is the documentation for Cocoon 2.2
> Probably there are some more things to do left - I will create a (more
> detailed) todo list this evening or tommorrow and share it with this list.
>
> Any help would be highly appreciated!!!!
I'll review your list and add things when necessary.
There are a few things left to do that probably need Thien's expertise.
This page is the home page and it typically has a different layout than
the other pages. E.g. the majority of the pages will consist of a left
menu column and a wide content column. I wonder if that is not going to
be too wide to read comfortably, or we should now agree that most people
use their browser at a size more or less equal to 1024 x 768 or less.
We also need some more styling elements:
- tables
- warning
- FIXME/TO DO
Bye, Helma