Calvin Hendryx-Parker wrote:
> Maybe we should throw up a wiki for user documentation?  It would be of
> real value to have this in a central place.

> In addition it would be
> nice to have the epydoc generated docs on the site too.

Is epydoc the same as the API documentation at e.g.
http://rdflib.net/rdflib-2.4.0/html/index.html ?
I surely use the that as a reference, but it's a overwhelming for
newbies (including me). For example, I was really puzzled at some point
that the documentation talked about rdflib.Graph.Graph, while the code
had to use rdflib.Graph -- the "import Graph from rdflib.Graph as Graph"
put me off track, rather then helping me -- I haven't even touched on
the more advanced concepts!).

I hope the authors distribute my example (perhaps a bit modified) in the
source, along with the two existing sample code files.

However, the rdflib website surely is missing a "documentation" tab.
For starters, you can point to:
* The example files (there are now 2 examples to create RDF statements,
  my previous mail is an example to read RDF statements).
* The API documentation as noted above
* http://rdflib.net/store/
* http://en.wikipedia.org/wiki/RDFLib
*http://dev.w3.org/cvsweb/~checkout~/2004/PythonLib-IH/Doc/sparqlDesc.html
(though the described method doesn't work as-is anymore since RDFlib 2.4.0)

Regards,
Freek

Attachment: signature.asc
Description: OpenPGP digital signature

_______________________________________________
Dev mailing list
Dev@rdflib.net
http://rdflib.net/mailman/listinfo/dev

Reply via email to