Last Comment Bug 11347 - clean up old RDF documentation
: clean up old RDF documentation
Product: Core
Classification: Components
Component: RDF (show other bugs)
: Trunk
: All All
P3 normal (vote)
: ---
Assigned To: Chris Waterson
: Axel Hecht [:Pike]
Depends on:
Blocks: 11414
  Show dependency treegraph
Reported: 1999-08-05 13:02 PDT by Chris Waterson
Modified: 2017-02-03 12:17 PST (History)
3 users (show)
See Also:
Crash Signature:
QA Whiteboard:
Iteration: ---
Points: ---
Has Regression Range: ---
Has STR: ---


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

Slightly-too-freeform notes on the various docs follow...
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?
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 or shall I just tidy it
up? It's linked too from a number of places so needs fixing.

Persistent client store -
        - 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 seems particuarly
worthy of a 'historical interest' corner.

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

 - 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 -
 - Delete; replace with links into CVS and bugtracker for now?

To-do list:
        - someone who knows the code needs to look at this and update
Comment 1 User image 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 User image Chris Waterson 1999-08-26 20:26:59 PDT
Moving out non-critical tasks.
Comment 3 User image Paul MacQuiddy 1999-11-30 12:44:59 PST
removing qa contact
Comment 4 User image 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.