You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jena.apache.org by Ian Dickinson <ia...@epimorphics.com> on 2011/10/26 00:45:50 UTC

SDB documentation

I have a process(*) for moving content from the openjena.org wiki to the 
CMS, which I've piloted by migrating the SDB documentation. I've not 
done very much cleanup, apart from fixing a few minor typos. The docs 
are in staging, but not published externally yet.

Could someone with a better knowledge of SDB than me take a quick look 
to see if anything obvious has gone wrong, but also to check if any of 
the words in the docs are now wildly out of date?

http://jena.staging.apache.org/jena/documentation/sdb/index.html

Ta,
Ian

(*) 80% automated, 20% manual


Re: SDB documentation

Posted by Damian Steer <d....@bristol.ac.uk>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 26/10/11 12:03, Ian Dickinson wrote:
> On 26/10/11 11:50, Damian Steer wrote:
>> [various good catches]
> Thanks Damian.
> 
>> Is it ok if I fix those issues?
> Yes, please!

Done (I hope).

Aside: seem to be two issues with this conversion.

1) Definition lists. Appears to be an extension to md, and one that
varies (hurrah).

Need to change:

Term
  ~ definition here

to

Term
:  definition here

2) Internal links for contents. Link was Mixed_Case, but ids were
lower_case.

Damian
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk6n/oIACgkQAyLCB+mTtylMEwCdFJNa/aoAYuVB0aSYfmRLXOi9
KzoAoLvMWYR9I0IScrRqoyZgQRy5FCIc
=7EMJ
-----END PGP SIGNATURE-----

Re: SDB documentation

Posted by Ian Dickinson <ia...@epimorphics.com>.
On 26/10/11 11:50, Damian Steer wrote:
> [various good catches]
Thanks Damian.

> Is it ok if I fix those issues?
Yes, please!

Ian

Re: SDB documentation

Posted by Damian Steer <d....@bristol.ac.uk>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 25/10/11 23:45, Ian Dickinson wrote:
> I have a process(*) for moving content from the openjena.org wiki
> to the CMS, which I've piloted by migrating the SDB documentation.
> I've not done very much cleanup, apart from fixing a few minor
> typos. The docs are in staging, but not published externally yet.
> 
> Could someone with a better knowledge of SDB than me take a quick
> look to see if anything obvious has gone wrong, but also to check
> if any of the words in the docs are now wildly out of date?
> 
> http://jena.staging.apache.org/jena/documentation/sdb/index.html
> 
> Ta, Ian
> 
> (*) 80% automated, 20% manual
> 

Thanks very much for converting this Ian. Only noticed two issues:

<http://jena.staging.apache.org/jena/documentation/sdb/store_description.html>

* There are numerous tildes in the 'Vocabulary' section (looks like
they were originally definition lists?)

<http://jena.staging.apache.org/jena/documentation/sdb/loading_data.html>

* Minor typo / thinko has been faithfully converted ('DISTINCT because
new nodes may contain duplicates' s/nodes/triples)

Nothing in there is really out of date, but some sections could
probably be merged or even removed, e.g.

<http://jena.staging.apache.org/jena/documentation/sdb/query.html>

Is it ok if I fix those issues?

Damian
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk6n5fsACgkQAyLCB+mTtylGFgCfckdQ1siVh+Uz4jo1eoGGAgvS
B84An1LimuiMyuT3P2GBesGDDrXfnWoJ
=KAq5
-----END PGP SIGNATURE-----