You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by dion <di...@multitask.com.au> on 2002/01/27 08:43:25 UTC

Updating sub-project web pages (again)

I've created a directory in cvs for latka 
(jakarta-commons/latka/webpages) with the output of the xsl transform.

If someone with a jakarta.apache.org account would check these out on 
that box I'd be very grateful.

Or alternatively, if someone would like to give me the appropriate 
access, I'd be happy to do it myself.

Regards,

-- 
dIon Gillard, Multitask Consulting
http://www.multitask.com.au/developers



--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by dIon Gillard <di...@multitask.com.au>.
robert burrell donkin wrote:

> i've now updated the live web site.
>
> - robert
>
Thanks, now for that automated build set up :)

-- 
dIon Gillard, Multitask Consulting
http://www.multitask.com.au/developers




--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by robert burrell donkin <ro...@mac.com>.
i've now updated the live web site.

- robert

On Sunday, January 27, 2002, at 11:10 PM, dion wrote:

> robert burrell donkin wrote:
>
>> On Sunday, January 27, 2002, at 09:01 PM, dion wrote:
>>
>> <snip>
>>
>>> Have updated the status page with my name, changed the release from 1.0 
>>> alpha 2 to 1.0 alpha 1 and removed the fix documentation todo :), oh 
>>> and committed to cvs
>>>
>>> Thanks for this. Whenever you get around to it would be fine with me. 
>>> Thanks again!
>>
>>
>> one thing i've noticed is that your name has unusual capitalization in 
>> status.html -
>>
>> dIon Gillard
>>
>> is this what you want?
>
> Yep, long story, but that's the electronic way it's spelt...
>
>>
>> also TestCommoneWebsite.xml has <!DOCTYPE suite SYSTEM "../../conf/suite.
>> dtd">. i don't think that this reference will work on the website.
>>
>> - robert
>
> Good call.... I've made the DTDs public ala the struts style, and placed 
> them in the latka site under dtds. I've updated TestCommonsWebsite.xml to 
> reference the public dtd.
>
> All committed now to cvs.
>
> Again, thanks. Documentation is one of the most important things we can 
> do to help Jakarta and it's projects gain more acceptance.
>
> -- dIon Gillard, Multitask Consulting
> http://www.multitask.com.au/developers
>
>
>
>
> --
> To unsubscribe, e-mail:   <mailto:commons-dev-unsubscribe@jakarta.apache.
> org>
> For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.
> org>
>


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by dion <di...@multitask.com.au>.
robert burrell donkin wrote:

> On Sunday, January 27, 2002, at 09:01 PM, dion wrote:
>
> <snip>
>
>> Have updated the status page with my name, changed the release from 
>> 1.0 alpha 2 to 1.0 alpha 1 and removed the fix documentation todo :), 
>> oh and committed to cvs
>>
>> Thanks for this. Whenever you get around to it would be fine with me. 
>> Thanks again!
>
>
> one thing i've noticed is that your name has unusual capitalization in 
> status.html -
>
> dIon Gillard
>
> is this what you want? 

Yep, long story, but that's the electronic way it's spelt...

>
> also TestCommoneWebsite.xml has <!DOCTYPE suite SYSTEM 
> "../../conf/suite.dtd">. i don't think that this reference will work 
> on the website.
>
> - robert 

Good call.... I've made the DTDs public ala the struts style, and placed 
them in the latka site under dtds. I've updated TestCommonsWebsite.xml 
to reference the public dtd.

All committed now to cvs.

Again, thanks. Documentation is one of the most important things we can 
do to help Jakarta and it's projects gain more acceptance.

-- 
dIon Gillard, Multitask Consulting
http://www.multitask.com.au/developers




--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by robert burrell donkin <ro...@mac.com>.
On Sunday, January 27, 2002, at 09:01 PM, dion wrote:

<snip>

> Have updated the status page with my name, changed the release from 1.0 
> alpha 2 to 1.0 alpha 1 and removed the fix documentation todo :), oh and 
> committed to cvs
>
> Thanks for this. Whenever you get around to it would be fine with me. 
> Thanks again!

one thing i've noticed is that your name has unusual capitalization in 
status.html -

dIon Gillard

is this what you want?

also TestCommoneWebsite.xml has <!DOCTYPE suite SYSTEM 
"../../conf/suite.dtd">. i don't think that this reference will work on 
the website.

- robert


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by dion <di...@multitask.com.au>.
robert burrell donkin wrote:

> if you can make any improvements to that document, please create a patch. 

I've been thinking about it for a while now....

> ok.
> i've updated the live web site. i'd appreciate it if people could take 
> a quick look and make sure that everything's where it should be. 

Looks good to me.

>
>
>
> the new pages look pretty good - but there is just one (little) thing...
>
> the commons guidelines state
>
> "15. Each committer has karma to all the packages, but committers are 
> required to add their name to a package's status file before their 
> first commit to that package."
>
> i believe that you've forgotten to add your name to the list of latka 
> committers in the project status file :)
>
> (while you're at it, you might like to update the release information 
> in there as well.)
>
> - robert 

Have updated the status page with my name, changed the release from 1.0 
alpha 2 to 1.0 alpha 1 and removed the fix documentation todo :), oh and 
committed to cvs

Thanks for this. Whenever you get around to it would be fine with me. 
Thanks again!

-- 
dIon Gillard, Multitask Consulting
http://www.multitask.com.au/developers




--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by robert burrell donkin <ro...@mac.com>.
hi dion

On Sunday, January 27, 2002, at 02:00 PM, dion wrote:

> robert burrell donkin wrote:

<snip>

>> 2. you might find http://jakarta.apache.org/site/jakarta-site2b.html 
>> useful in understanding the web page update system.
>
> Read it several times...hence the major change in latka's docs.

if you can make any improvements to that document, please create a patch.

>> from looking at the directories it appears to me that latka's web pages 
>> are not (in the standard place) in cvs but instead are copied into 
>> position by hand.
>
> I wouldn't know for sure, since I wasn't around when they were originally 
> set up. Hence the replacements generated using the stylesheet version of 
> anakia.

cool.

<snip>

> Ok, I've created a new latka directory in jakarta-commons/docs and 
> updated the build file so that webpages builds will go into that 
> directory. I've built our documentation into that directory and tested 
> locally, and committed into jakarta-commons/docs/latka
>
> If this is ok by you, i think they're ready to go.

ok.
i've updated the live web site. i'd appreciate it if people could take a 
quick look and make sure that everything's where it should be.


the new pages look pretty good - but there is just one (little) thing...

the commons guidelines state

"15. Each committer has karma to all the packages, but committers are 
required to add their name to a package's status file before their first 
commit to that package."

i believe that you've forgotten to add your name to the list of latka 
committers in the project status file :)

(while you're at it, you might like to update the release information in 
there as well.)

- robert


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by dion <di...@multitask.com.au>.
robert burrell donkin wrote:

> hi dion
>
> On Sunday, January 27, 2002, at 07:43 AM, dion wrote:
>
>> I've created a directory in cvs for latka 
>> (jakarta-commons/latka/webpages)
>>  with the output of the xsl transform.
>>
>> If someone with a jakarta.apache.org account would check these out on 
>> that box I'd be very grateful.
>
>
> i'd be happy to do so but i've found a few wrinkles so i'd like to 
> sort them out first rather than risk making a mistake. 

Cool...

>> Or alternatively, if someone would like to give me the appropriate 
>> access,
>>  I'd be happy to do it myself.
>
>
> (you probably know these two points already but just in case you 
> don't...)
>
> 1. i believe (hopefully people will correct me if i'm wrong) that new 
> committers are no longer being given logon's to jakarta.apache.org. 
> most people who have been committers for a while still have their's 
> but i believe that the ASF would like to reduce the number of people 
> with logons to jakarta.apache.org. (which is one good reason to think 
> about automatically updating the web site.) if you do want to try to 
> get a logon then i think that general is the right place to ask. 

I'm happy with something that's easy for everyone :)

> 2. you might find http://jakarta.apache.org/site/jakarta-site2b.html 
> useful in understanding the web page update system. 

Read it several times...hence the major change in latka's docs.

>
> from looking at the directories it appears to me that latka's web 
> pages are not (in the standard place) in cvs but instead are copied 
> into position by hand. 

I wouldn't know for sure, since I wasn't around when they were 
originally set up. Hence the replacements generated using the stylesheet 
version of anakia.

> i'm willing to copy your web pages into position but i won't be able 
> test them first. so if this is what you want me to do i'll probably 
> need to check with you exactly what's needed and which of the existing 
> pages you want to keep.
>
> on the other hand, most other projects use the jakarta-commons/docs 
> folder for their web pages. they are committed into cvs and then the 
> live web site is updated from there. maybe latka would like to begin 
> using this system. if you want to go down that route, then i'd be 
> happy to help with that too. 

This sounds fine for me. I think Latka would benefit from getting docs 
into a standard place, and being part of a regular update. Part of what 
I've done is rework the existing docs and build process into something 
that creates html from anakia's document format (via docbook).

> the choice is yours...
>
> - robert
>
>
Ok, I've created a new latka directory in jakarta-commons/docs and 
updated the build file so that webpages builds will go into that 
directory. I've built our documentation into that directory and tested 
locally, and committed into jakarta-commons/docs/latka

If this is ok by you, i think they're ready to go.

-- 
dIon Gillard, Multitask Consulting
http://www.multitask.com.au/developers




--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>


Re: Updating sub-project web pages (again)

Posted by robert burrell donkin <ro...@mac.com>.
hi dion

On Sunday, January 27, 2002, at 07:43 AM, dion wrote:

> I've created a directory in cvs for latka (jakarta-commons/latka/webpages)
>  with the output of the xsl transform.
>
> If someone with a jakarta.apache.org account would check these out on 
> that box I'd be very grateful.

i'd be happy to do so but i've found a few wrinkles so i'd like to sort 
them out first rather than risk making a mistake.

> Or alternatively, if someone would like to give me the appropriate access,
>  I'd be happy to do it myself.

(you probably know these two points already but just in case you don't...)

1. i believe (hopefully people will correct me if i'm wrong) that new 
committers are no longer being given logon's to jakarta.apache.org. most 
people who have been committers for a while still have their's but i 
believe that the ASF would like to reduce the number of people with logons 
to jakarta.apache.org. (which is one good reason to think about 
automatically updating the web site.) if you do want to try to get a logon 
then i think that general is the right place to ask.

2. you might find http://jakarta.apache.org/site/jakarta-site2b.html 
useful in understanding the web page update system.


from looking at the directories it appears to me that latka's web pages 
are not (in the standard place) in cvs but instead are copied into 
position by hand.

i'm willing to copy your web pages into position but i won't be able test 
them first. so if this is what you want me to do i'll probably need to 
check with you exactly what's needed and which of the existing pages you 
want to keep.

on the other hand, most other projects use the jakarta-commons/docs folder 
for their web pages. they are committed into cvs and then the live web 
site is updated from there. maybe latka would like to begin using this 
system. if you want to go down that route, then i'd be happy to help with 
that too.

the choice is yours...

- robert



--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>