You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@sis.apache.org by Martin Desruisseaux <ma...@geomatys.fr> on 2013/03/20 11:29:33 UTC
Legal question: policy for Javadoc derived from OGC/ISO specification?
Hello all
Since the metadata classes to be committed to SIS implement GeoAPI
interfaces, the Javadoc of those classes reproduce the GeoAPI Javadoc.
Not necessarily identical (they are sometime extended with SIS-specific
explanations), but still close. Those Javadoc are themselves derived
from OGC/ISO specifications (again not identical since they have been
adapted to the Java world). Most of them are single sentences like "Name
and position information for an individual or organization that is
responsible for the resource."
I asked a while ago to some OGC peoples about that, and I have been told
that this was okay since the goal of the specification authors is to see
their standards widespread. Furthermore, the original texts are already
distributed in XML format at http://schemas.opengis.net (see for example
[1]). So if I'm understanding right, including those texts (in a
modified form) in the SIS Javadoc could be seen as "fair use" in the
spirit of standards. Do other peoples have similar feeling?
For the classes containing such Javadoc, I add the following paragraph
just below the Apache 2 license. Does it sound something okay?
This package contains documentation from OGC specifications.
Open Geospatial Consortium's work is fully acknowledged here.
Martin
[1] http://schemas.opengis.net/iso/19139/20070417/gmd/citation.xsd
Re: Legal question: policy for Javadoc derived from OGC/ISO specification?
Posted by Martin Desruisseaux <ma...@geomatys.fr>.
Hello Adam and Joe
Thanks for the feedback. I went away as suggested.
The port is still progressing - taking me longer than I though. The JDK7
build will hopefully be back tomorrow.
Martin
Le 20/03/13 12:58, Joe White a écrit :
> Guys,
> I think that sounds reasonable to me.
>
> Joe
> On Mar 20, 2013, at 7:47 AM, Adam Estrada <es...@gmail.com> wrote:
>
>> Hey Martin,
>>
>> I think that it might be ok to implement everything as you suggested as long as you do cite OGC/ISO acknowledgements. Does everyone else feel the same way?
>>
>> Adam
Re: Legal question: policy for Javadoc derived from OGC/ISO specification?
Posted by Joe White <wh...@gmail.com>.
Guys,
I think that sounds reasonable to me.
Joe
On Mar 20, 2013, at 7:47 AM, Adam Estrada <es...@gmail.com> wrote:
> Hey Martin,
>
> I think that it might be ok to implement everything as you suggested as long as you do cite OGC/ISO acknowledgements. Does everyone else feel the same way?
>
> Adam
>
> On Mar 20, 2013, at 6:29 AM, Martin Desruisseaux wrote:
>
>> Hello all
>>
>> Since the metadata classes to be committed to SIS implement GeoAPI interfaces, the Javadoc of those classes reproduce the GeoAPI Javadoc. Not necessarily identical (they are sometime extended with SIS-specific explanations), but still close. Those Javadoc are themselves derived from OGC/ISO specifications (again not identical since they have been adapted to the Java world). Most of them are single sentences like "Name and position information for an individual or organization that is responsible for the resource."
>>
>> I asked a while ago to some OGC peoples about that, and I have been told that this was okay since the goal of the specification authors is to see their standards widespread. Furthermore, the original texts are already distributed in XML format at http://schemas.opengis.net (see for example [1]). So if I'm understanding right, including those texts (in a modified form) in the SIS Javadoc could be seen as "fair use" in the spirit of standards. Do other peoples have similar feeling?
>>
>> For the classes containing such Javadoc, I add the following paragraph just below the Apache 2 license. Does it sound something okay?
>>
>> This package contains documentation from OGC specifications.
>> Open Geospatial Consortium's work is fully acknowledged here.
>>
>>
>> Martin
>>
>>
>> [1] http://schemas.opengis.net/iso/19139/20070417/gmd/citation.xsd
>>
>
Re: Legal question: policy for Javadoc derived from OGC/ISO specification?
Posted by Adam Estrada <es...@gmail.com>.
Hey Martin,
I think that it might be ok to implement everything as you suggested as long as you do cite OGC/ISO acknowledgements. Does everyone else feel the same way?
Adam
On Mar 20, 2013, at 6:29 AM, Martin Desruisseaux wrote:
> Hello all
>
> Since the metadata classes to be committed to SIS implement GeoAPI interfaces, the Javadoc of those classes reproduce the GeoAPI Javadoc. Not necessarily identical (they are sometime extended with SIS-specific explanations), but still close. Those Javadoc are themselves derived from OGC/ISO specifications (again not identical since they have been adapted to the Java world). Most of them are single sentences like "Name and position information for an individual or organization that is responsible for the resource."
>
> I asked a while ago to some OGC peoples about that, and I have been told that this was okay since the goal of the specification authors is to see their standards widespread. Furthermore, the original texts are already distributed in XML format at http://schemas.opengis.net (see for example [1]). So if I'm understanding right, including those texts (in a modified form) in the SIS Javadoc could be seen as "fair use" in the spirit of standards. Do other peoples have similar feeling?
>
> For the classes containing such Javadoc, I add the following paragraph just below the Apache 2 license. Does it sound something okay?
>
> This package contains documentation from OGC specifications.
> Open Geospatial Consortium's work is fully acknowledged here.
>
>
> Martin
>
>
> [1] http://schemas.opengis.net/iso/19139/20070417/gmd/citation.xsd
>
Re: Legal question: policy for Javadoc derived from OGC/ISO specification?
Posted by Adam Estrada <es...@gmail.com>.
I think it looks great, Martin.
Thanks,
Adam
On Thu, Mar 21, 2013 at 4:32 AM, Martin Desruisseaux <
martin.desruisseaux@geomatys.fr> wrote:
> Hello Chris
>
> Le 21/03/13 03:24, Mattmann, Chris A (388J) a écrit :
>
> I think it's totally fair use, especially in the context of Javadoc.
>>
>> However, we don't modify the Apache License, version 2, we add
>> the statement you mentioned to our NOTICE.txt file (I think).
>>
>
> Thanks for pointing that. Looking at the NOTICE file, it seems to make
> sense. So I removed the note from all Java headers and added the following
> in the NOTICE file instead:
>
> The Javadoc contains documentation from the Open Geospatial Consortium
> (OGC®) specifications (http://www.opengeospatial.**org/standards/<http://www.opengeospatial.org/standards/>),
> also
> known as OpenGIS.
>
>
> If anyone think that it should be done otherwise, please let me know.
>
> Martin
>
>
Re: Legal question: policy for Javadoc derived from OGC/ISO specification?
Posted by Martin Desruisseaux <ma...@geomatys.fr>.
Hello Chris
Le 21/03/13 03:24, Mattmann, Chris A (388J) a écrit :
> I think it's totally fair use, especially in the context of Javadoc.
>
> However, we don't modify the Apache License, version 2, we add
> the statement you mentioned to our NOTICE.txt file (I think).
Thanks for pointing that. Looking at the NOTICE file, it seems to make
sense. So I removed the note from all Java headers and added the
following in the NOTICE file instead:
The Javadoc contains documentation from the Open Geospatial Consortium
(OGC®) specifications (http://www.opengeospatial.org/standards/), also
known as OpenGIS.
If anyone think that it should be done otherwise, please let me know.
Martin
Re: Legal question: policy for Javadoc derived from OGC/ISO
specification?
Posted by "Mattmann, Chris A (388J)" <ch...@jpl.nasa.gov>.
Hi Martin,
I think it's totally fair use, especially in the context of Javadoc.
However, we don't modify the Apache License, version 2, we add
the statement you mentioned to our NOTICE.txt file (I think).
Kevan M -- thoughts?
Cheers,
Chris
On 3/20/13 3:29 AM, "Martin Desruisseaux"
<ma...@geomatys.fr> wrote:
>Hello all
>
>Since the metadata classes to be committed to SIS implement GeoAPI
>interfaces, the Javadoc of those classes reproduce the GeoAPI Javadoc.
>Not necessarily identical (they are sometime extended with SIS-specific
>explanations), but still close. Those Javadoc are themselves derived
>from OGC/ISO specifications (again not identical since they have been
>adapted to the Java world). Most of them are single sentences like "Name
>and position information for an individual or organization that is
>responsible for the resource."
>
>I asked a while ago to some OGC peoples about that, and I have been told
>that this was okay since the goal of the specification authors is to see
>their standards widespread. Furthermore, the original texts are already
>distributed in XML format at http://schemas.opengis.net (see for example
>[1]). So if I'm understanding right, including those texts (in a
>modified form) in the SIS Javadoc could be seen as "fair use" in the
>spirit of standards. Do other peoples have similar feeling?
>
>For the classes containing such Javadoc, I add the following paragraph
>just below the Apache 2 license. Does it sound something okay?
>
> This package contains documentation from OGC specifications.
> Open Geospatial Consortium's work is fully acknowledged here.
>
>
> Martin
>
>
>[1] http://schemas.opengis.net/iso/19139/20070417/gmd/citation.xsd
>