Last Comment Bug 11347 - clean up old RDF documentation
: clean up old RDF documentation
Status: RESOLVED FIXED
:
Product: Core
Classification: Components
Component: RDF (show other bugs)
: Trunk
: All All
: P3 normal (vote)
: ---
Assigned To: Chris Waterson
:
:
Mentors:
http://www.mozilla.org/rdf/doc/
Depends on:
Blocks: 11414
  Show dependency treegraph
 
Reported: 1999-08-05 13:02 PDT by Chris Waterson
Modified: 2000-12-15 18:37 PST (History)
3 users (show)
See Also:
Crash Signature:
(edit)
QA Whiteboard:
Iteration: ---
Points: ---
Has Regression Range: ---
Has STR: ---


Attachments

Description Chris Waterson 1999-08-05 13:02:22 PDT
From Dan:


Slightly-too-freeform notes on the various docs follow...

http://www.mozilla.org/rdf/doc/hypertree.html
I believe this is now thoroughly obsoleted by XUL etc. Would it make
sense for me to to 'cvs remove' it? Perhaps hanging on to the intro
paragraph for recycling elsewhere?


http://www.mozilla.org/rdf/doc/xml.html
This also leaps out as innacurate (the architecture doc) and
unrepresentative of the variosu cool things built since was written.
Is there a better 'XML home page' on mozilla.org or shall I just tidy it
up? It's linked too from a number of places so needs fixing.

Persistent client store - http://www.mozilla.org/rdf/doc/pcs.html
        - this is now misleading. Your persistence is into XML files
or bookmarks.html and the berekeley stuff is on hold, right? We could
add this to an 'get involved -- projects' sectoin maybe? As I understand
it PCS is not on the V5.0 feature list...?


Various others:
Shack, implementing RDF datasources, other docs --- some of these are
really crusty now, but have perhaps got some historical interest? My
inclination is to remove but won't do this without sayso...
I can do some housecleaning but wantto get the balance right between
tidying and trashing. Do you see any value in having the obsolete docs
still accessible at those URLs? Of these, only
http://www.mozilla.org/rdf/doc/rdfdatasources.html seems particuarly
worthy of a 'historical interest' corner.


The three 'roadmap' documents that are up there are also way old.

Suggestions:
http://www.mozilla.org/rdf/doc/roadmap.html
 - this is a good basis for a "get involved" page but a bad roadmap. I
could rework it as such if you think ok.

State of the code doc - http://www.mozilla.org/rdf/doc/code.html
 - Delete; replace with links into CVS and bugtracker for now?


To-do list: http://www.mozilla.org/rdf/doc/ntd.html
        - someone who knows the code needs to look at this and update
Comment 1 Dan Brickley 1999-08-11 09:24:59 PDT
Made a bit of progress with doc tidying. The tech overview has been interfered
with in various ways, as has front page at /rdf/doc/, for example to draw a
clearer distinction between the Mozilla RDF implementation (which has things
like a query API, ability to express -ve assertions etc) and the formal W3C
specifications (which generally have gone unmentioned in older docs).  The main
RDF page is less misleading now and the older junkier docs have been unlinked
from that page. Basically we Ion't link it from main page or a subsidiary, it's
(as far as I'm concerned) a candidate for 'cvs -remove'.

Should we have a top-level 'tracking bug' for W3C spec violations w.r.t. the
RDF specs? (and XML specs?). Would be good to itemise the places where the
parser and query API don't accord with official specs...
Comment 2 Chris Waterson 1999-08-26 20:26:59 PDT
Moving out non-critical tasks.
Comment 3 Paul MacQuiddy 1999-11-30 12:44:59 PST
removing qa contact
Comment 4 Chris Waterson 2000-06-09 09:24:05 PDT
clean enuf. will file new bugs if appropriate.

Note You need to log in before you can comment on or make changes to this bug.