Re: Public Sites :: Update

Marcel van der Boom <[email protected]> Sat, 19 Oct 2002 10:17:10 +0200
Newsgroups gmane.comp.cms.xaraya.documentation
Organization HS-Development BV
Message-ID <[email protected]>
Doug Daulton (Apakuni) wrote:

> Please get resources (dir list and doc files to me ASAP ... preferably by
> Saturday evening if you want them included in launch.

List of resources:

RFC documents:
==============
RFCs are in repository under docs/rfc. The makefile creates html files out 
of them: 
-> make html

For text format, change this to make txt. For the xml capable browser a xsl 
stylesheet is provided and all xml files have this in their preamble.

I'd be in favour of making this dynamic right away (not much work):
- the tcl script in the docs/rfc dir takes care of the conversion, so the 
server needs to know tcl, which is not a problem i think.
- by running the makefile with the specific target and then copying the 
docs to their location. the running of the makefile can be done directly in 
the repository. Files will automatically be checked out when needed.

GANTT roadmap.
==============
I have a little php script which produces the roadmap from a text database
For this to be dynamically generated it is enough to stick this php file 
into a suitable location and the text database next to it. The graph is 
generated with the jpgraph library which needs gd support compiled into php.

I have just checked the files into the repository under 
docs/project/roadmap. 
 For this as well I think a simple cron job will do to check out the text 
database and the php file into the site location. (assuming supporting 
files haven't changed, but this can be easily checked in the cron job)
If the generation speed becomes a problem we can let the cron job generate 
the roadmap (produces a png image) and stick that into the web space, 
whatever you guys prefer. 

Downloadables
=============
The cron job which creates the weekly tarball is already in place and the 
downloads directory is on the server (dunno exactly where). These are all 
public files for download. Please make sure people know these are 
development snapshots by inserting the proper introduction text on the 
pages.


General remarks on site:
========================
- very good that it's happening! cheers to you all
- the roadmap document isn't yet in the repository yet, this will happen 
very soon, then it can be combined with the gantt roadmap in the same cron 
job, so the two are always synced up.
- maybe stick info on bk on the developer page? Do you want me to write a 
short tutorial for this page, extensive bk usage and management information 
(for committers) can be on bk.xaraya.com (think of: relationship diagram 
for active scenarios, links to webview of repositories, queries on which 
repositories are at which scenario level etc. There is a lot of information 
which is relevant only to committers, I think we don't need to polute the 
normal site with it. Most of it will be heavily dynamic.

That's it from me for now, I'll be probably in and out irc this weekend as 
we have a house full of guests. Let me know if I can help, I would like to 
have it done by sundays meeting time. 

Marcel

 

-- 
Marcel van der Boom, HS-Development BV
Kwartiersedijk 14B Fijnaart, The Netherlands
T: +31-168-468822, F: 0168-468823, E: [email protected]