[openbiblio-dev] Feedback on my BibJSON record

Sat Feb 23 15:26:18 UTC 2013

Mark, none of this is a motivation to not include a list of the terms in 
use. In fact, I know that Jim Pittman had such a list. For anyone 
starting to use bibjson, it is helpful to see such a list, not just a 
few very short examples. I find the example page woefully inadequate as 
the sole documentation.

kc

On 2/23/13 7:01 AM, Mark MacGillivray wrote:
> In answer to a number of queries over the recent few emails:
>
> The bibjson.org <http://bibjson.org> site is a list of the examples we
> have seen in use to date. If we gain consensus on a particular usage, we
> can add it to the list. For example, I am currently using
> "citation":[{...}] on another project, so would probably soon suggest we
> add that to the bibjson.org <http://bibjson.org> page.
>
> As regards dc:creator, the initial approach of bibjson growing from
> bibtex promotes that we use "author":[{...}] lists, and similarly
> "editor":[{...}] lists.
>
> For author name strings, following again from the bibtex examples
> bibjson came from, the author.name <http://author.name> field is
> expected to be of the form "MacGillivray Mark" as most people tend to
> search by last name first so it is easily supported. There are also
> examples of the use of specific firstname and lastname keys in addition
> to or instead of the full "name" key.
>
> For JSON-LD, all the linked data requirements that came up were
> answerable by the use of JSON-LD and bibjson combined, so we stated that
> on the web page. We did not provide any further example because there
> were no such examples at the time. If there are some now, we could add them.
>
> Similarly, there is no schema for bibjson because there were no examples
> of anyone using one at the time.
>
> The reason there are no examples of how to do things that had not been
> done is - at least from my personal perspective - that there is little
> point over-complicating things with examples of how to do stuff that
> people may never actually do in practice. I personally have not yet been
> presented with a use case that required me either to have a JSON-LD
> representation or a schema, so I did not waste time creating things I
> did not need.
>
> However, that said, where anyone does have examples of usage of such
> things, and therefore can provide such examples along with a description
> of the use cases they support, we should add them to the bibjson.org
> <http://bibjson.org> page. If anyone needs to create a schema, we could
> put that up too.
>
> Mark
>
>
>
>
>
>
>
> On Sat, Feb 23, 2013 at 8:16 AM, Sylvain Hellegouarch
> <sylvain.hellegouarch at gmail.com <mailto:sylvain.hellegouarch at gmail.com>>
> wrote:
>
>     Hi Tom,
>
>     2013/2/23 Tom Johnson <johnson.tom at gmail.com
>     <mailto:johnson.tom at gmail.com>>
>
>         If you are starting from BibJSON, JSON-LD "support" is as simple
>         as creating a context document mapping tokens to the desired
>         URIs. What the context document looks like depends mostly on
>         which vocabularies/terms you want in your graph. I'm guessing
>         this is the reason it was decided not to include an example in
>         the documentation.
>
>         I did some work on JSON-LD and BibJSON, published in the most
>         recent Code4Lib Journal. http://journal.code4lib.org/articles/7949
>
>         Is there is interest in an example context document and some
>         guidance documentation?
>
>         Sylvian: do you have a use case for the linked data?
>
>
>
>     As of now, it's neither a requirement nor a priority so I'm happy
>     enough concentrating already on having clean standalone BibJSON records.
>     --
>     - Sylvain
>     http://twitter.com/lawouach
>     http://www.defuze.org
>
>     _______________________________________________
>     openbiblio-dev mailing list
>     openbiblio-dev at lists.okfn.org <mailto:openbiblio-dev at lists.okfn.org>
>     http://lists.okfn.org/mailman/listinfo/openbiblio-dev
>     Unsubscribe: http://lists.okfn.org/mailman/options/openbiblio-dev
>
>
>
>
> _______________________________________________
> openbiblio-dev mailing list
> openbiblio-dev at lists.okfn.org
> http://lists.okfn.org/mailman/listinfo/openbiblio-dev
> Unsubscribe: http://lists.okfn.org/mailman/options/openbiblio-dev
>

-- 
Karen Coyle
kcoyle at kcoyle.net http://kcoyle.net
ph: 1-510-540-7596
m: 1-510-435-8234
skype: kcoylenet