search

API4KBs / api4kbs

API for Knowledge Based Platforms - Core Specifications
MIT License
8 stars 4 forks source link

Clarity in distinction between DOL and API4KB #32

Closed lonniev closed 8 years ago

lonniev commented 8 years ago

Reading the DOL spec and looking at the DOL ontology itself, it is clear what DOL is: an ontology for a distributed ontology language. Reading the LaTex API4KB, it is easy to get lost on what is API4KB because a large portion of that document speaks of what is DOL. This is confusing to a more general reader. If the confusion is more common than just a single instance of this reader (@lonniev) then document refactoring should be done to establish a more evident separation of concerns.

lonniev commented 8 years ago

@greenTara, there may be a more recent working copy of the API4KP draft. I am assuming that the link in #29 is our latest content. If I’m reading old materials, forgive me.

greenTara commented 8 years ago

Hi Lonnie - you should ignore everything in that draft after section 0. It is full of DOL stuff because we started with the DOL draft as our template, and then we are converting it to API4KB a little at a time. So far only Section 0 has been modified, so everything after that is essentially some draft of the DOL standard.

On Wed, Mar 23, 2016 at 2:10 PM, Lonnie VanZandt notifications@github.com wrote:

@greenTara https://github.com/greenTara, there may be a more recent working copy of the API4KP draft. I am assuming that the link in #29 https://github.com/API4KBs/api4kbs/issues/29 is our latest content. If I’m reading old materials, forgive me.

— You are receiving this because you were mentioned. Reply to this email directly or view it on GitHub https://github.com/API4KBs/api4kbs/issues/32#issuecomment-200338878

lonniev commented 8 years ago

Hi @lonniev - you should ignore everything in that draft after section 0. It is full of DOL stuff because we started with the DOL draft as our template, and then we are converting it to API4KB a little at a time. So far only Section 0 has been modified, so everything after that is essentially some draft of the DOL standard.

lonniev commented 8 years ago

@greenTara that is So Comforting to read: I was afraid you might reply that I was a silly twit who just didn’t get the big picture. (Not that you would so phrase it, of course.) Your explanation helps me a lot. I was spot on that the LaTex draft is an out of date precursor to the DOL spec. Cool. I rest in peace.