commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bruno P. Kinoshita" <brunodepau...@yahoo.com.br.INVALID>
Subject Re: [RDF] Draft introduction to Commons RDF
Date Mon, 21 Nov 2016 21:07:00 GMT
Great work Stian! Completed the tutorial in the main page, and the code in the examples
works flawlessly. Kudos.


Tried to push at least the trivial changes to https://git-wip-us.apache.org/repos/asf/incubator-commonsrdf.git
but got back a "remote: You are not authorized to edit this repository." error.


## Introduction


* In the first paragraph, the link to the Apache Commons RDF is pointing to /index.md, and
causing a 404. Not sure if this is due to the way the site was built? But probably worth checking.
The link in the third paragraph is wrong too. Instead of index.md, use index.html (tested
locally).

* This:

"Don’t worry about this syntax, RDF is a model with several ways to represent it when saved
to a file; the Commons RDF API directly reflects the RDF model in a syntax-neutral way."

Perhaps could be rewritten as

RDF is a model with several ways to represent it when saved to a file. The Commons RDF API
directly reflects the RDF model in a syntax-neutral way. So do not worry about the syntax
for now.

?

* I think there is a typo here:

"Note: Using .findFirst() will not returned the “first” recorded triple, as triples in
a graph are not necessarily kept in order."

s/returned/return/

* Under Typed Literals, I think there is another trivial typo.

"RDF reuse the XSD datatypes."

s/reuse/reuses/

## Implementations (followed this link from the intro, just to take a quick look)

* The local link to external implementations is broken. It must be External_implementations
instead of External-implementations

* Under Eclipse RDF4J, in the first paragraph, it says Eclispe.

* In the bottom, in the External implementations section, there is a link to a line in a source
file in GitHub. As it may change, it is better to reference a commit. You can go to that screen,
click on the line number again, and then hit the "y" key in your keyboard. That should redirect
you to the current commit URL with the most recent version of that code.

Will take a look at the other sections later this week if I find some spare time.

Cheers
Bruno

>________________________________
> From: Stian Soiland-Reyes <stain@apache.org>
>To: Commons Developers List <dev@commons.apache.org> 
>Sent: Tuesday, 22 November 2016 3:09 AM
>Subject: [RDF] Draft introduction to Commons RDF
> 
>
>As raised in the recent vote, Commons RDF could do with an
>introduction to RDF for people who have not used RDF before. The API
>should be quite suitable for RDF beginners, as unlike say Jena or
>Sesame they should not be so easily overwhelmed by the API size.
>
>
>Here's my first attempt at such a tutorial:
>http://commonsrdf.incubator.apache.org/introduction.html
>
>
>Feedback welcome - particularly from Commons folks who don't know too
>much about RDF!
>
>
>Note that this tutorial does not yet go into the crucial part of
>loadinh/save of RDF files, as that involves using the other RDF
>implementations, which would require use of Maven for dependencies. I
>thing a second tutorial could cover that aspect.
>
>-- 
>Stian Soiland-Reyes
>http://orcid.org/0000-0001-9842-9718
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>For additional commands, e-mail: dev-help@commons.apache.org
>
>
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message