ABOUT THIS FILETREE.

Dan and Libby manage these files. Please keep any
changes in sync with their brains.

danbri@w3.org
libby.miller@bristol.ac.uk

Several kinds of things can be found here.

Most importantly, descriptions of the 15 SWAD-Europe workpackages.


Access control: 
	anything below this directory should be ok in
	public view.

These are in a special dialect of XHTML designed to
allow project management metadata to be extracted
automatically. Filenames: esw-wp-*.html

You probably don't want to edit these html files until the format is properly 
documented. However you could use the generated files and other RDF files 
if you like:

rdf/_esw_projdata.rdf
(generated from xhtml files; information about partners, deliverable effort, descriptions of deliverables)

rdf/_esw_rssevents_delivs.rdf
(rss+events file for deliverables, generated by bin/esw-delivs-events.rb, from 
rdf/whodoeswhat.rdf
rdf/partners.rdf
rdf/_esw_projdata.rdf)

rdf/partners.rdf
(hand-written details about partners and people)

rdf/whodoeswhat.rdf
(a handwritten RDF file about who is leading, has effort on or is interested in each 
deliverable. This came from notes made in the first face to face. There's also 
a text version avilable.)

rdf/_deliv_detail.csv
(a comma-separated variable file for importing information about which deliverables 
are due when and who is responsible. More info is available in the file).


In addition to these main files, you will find the
following. File named with an initial _ are derrived
files.

_autotoc.html
	automatically generated table of contents.

	these won't change, so should turn it into a proper
	page?

_chartindex.html
	for images. not used yet.

_concat.html
	a big concat'nation of workplan...

_delivtable.html
	overview of deliverables.





bin/  	-- software tools, utilities

bin/extract_projdata.pl -- the main swad-e workplan script

	concat.pl -- crude Perl to merge several HTML docs into one 
	mktoc.pl -- used to make table of contents (?to remove)
	esw-report.rb -- work in progress, client to use
		RDF query to build an iCalendar/palm view
		of datebook.

	A couple of (linux) binaries for image generation:
		ascii_chart
		piechart
	(included for convenience, see bin/README.txt)


views/	-- autogenerated document views of the workplan
	views/img/ -- autogenerated images (charts, graphs etc)
	views/deliverables/ -- one HTML page per deliverable.


rdf/	-- RDF views of workplan.
	 -- files named _* are autogenerated.
	    others are primary representation of that data.


conf/
	-- configuration files
	concat.txt, orig.txt, workplan.txt
		made up config format used by concat.pl
		to assemble a document from a collection.
		orig.txt was used in contract preparation.
		workplan.txt is just workpackages.
		concat.txt is the default file.