[Incubator] Motion: Project Terra Draw community project initative

Thu Sep 19 09:09:20 PDT 2024

 Most headers just indicate the license name and say available in the root
of the software project or something. I do understand that JS projects are
sensitive to character count - so it is fine to avoid headers - as long as
you are doing so on purpose. I think there is often a compile step these
days for JS projects that takes care of comments (and even long variable
names).

As for Leaflet - the OSGeo website is very much in the "empower everyone"
mandate and lists all the projects it can.
It is for all foss4g software - and is not limited to those that decided to
join the foundation. This is about serving the public after all.
- -
Jody Garnett

On Sep 19, 2024 at 4:01:52 AM, James Milner <jamesmilner22 at hotmail.com>
wrote:

> Hi Jody,
>
> Thanks for writing out those points, interesting reading. I appreciate
> that the file headers are probably a better practice from a licensing
> perspective, although there is a slight trade off in that they can add some
> 'bulk' to files so to speak which add some friction. Let me think about
> that a bit more and what might work well there. Are you aware of scenarios
> where people simply reference the copyright name and date and the license
> name, rather than the full license text? That might be a good compromise.
> On the Leaflet point, it is worth noting that the project is listed on the
> OSGeo website under projects which might be slightly confusing: Leaflet -
> OSGeo <https://www.osgeo.org/projects/leaflet/>
>
> All the best,
>
> James
>
> ------------------------------
> *From:* Jody Garnett <jody.garnett at gmail.com>
> *Sent:* 19 September 2024 08:02
> *To:* James Milner <jamesmilner22 at hotmail.com>
> *Cc:* incubator at lists.osgeo.org <incubator at lists.osgeo.org>; Nick Bearman
> <nick at nickbearman.com>
> *Subject:* Re: [Incubator] Motion: Project Terra Draw community project
> initative
>
> Hi James,
>
> I am happy - the point is to have this conversation and check that you are
> doing things on purpose.
>
>
>    - We did confirm that a copyright is not needed on the top of each
>    file, it is just a good practice, but revision history can establish
>    authorship.
>    - We were advised by a lawyer a few years ago that it was a good
>    practice to have a license at the top of each file - since many folks
>    discover code by searching these days.
>    (So not a requirement just passing that on).
>    - OpenLayers did the much more extensive checking each file history
>    <https://wiki.osgeo.org/wiki/OpenLayers_Provenance_Review>, they also
>    have a CLA so great tradability that everyone understood they were adding
>    to an open source project.
>    - Leaflet is a great project but not associated with OSGeo
>
>
> - -
> Jody Garnett
>
>
> On Sep 19, 2024 at 12:43:47 AM, James Milner <jamesmilner22 at hotmail.com>
> wrote:
>
> Hey Jody,
>
> Thanks for your reply. I guess I am still looking for a definition of what
> you mean by 'applied correctly' in this scenario. The repository has an MIT
> License file and there is no source code in the project (to my
> knowledge) that is not MIT compatibly licensed. To my understanding, unlike
> Apache 2 or GPL the MIT Licence does not require it to be referenced at the
> top of every source file.
>
> If it is a requirement of being a OSGeo Community Project I can look at
> how we could apply a short notice to the top of the source files. Just an
> observation on this more broadly though, I checked the source for OpenLayers
> (BSD-2)
> <https://github.com/openlayers/openlayers/blob/main/src/ol/extent/Relationship.js> and
> Leaflet (BSD-2)
> <https://github.com/Leaflet/Leaflet/blob/main/src/map/Map.js>, and
> neither seem to have a notice at the top of their source files.
>
> Regarding the documentation, currently I would consider the docs to be MIT
> Licensed although with the rest of the project, but I see why the docs been
> CC0 being helpful. Let me think on that as it's a great point.
>
> Many thanks,
>
> James
>
> ------------------------------
> *From:* Jody Garnett <jody.garnett at gmail.com>
> *Sent:* 19 September 2024 04:42
> *To:* James Milner <jamesmilner22 at hotmail.com>
> *Cc:* incubator at lists.osgeo.org <incubator at lists.osgeo.org>; Nick Bearman
> <nick at nickbearman.com>
> *Subject:* Re: [Incubator] Motion: Project Terra Draw community project
> initative
>
> I am looking for an assurance from you that the license has been applied
> correctly.
>
> *The assur*ance that you have checked, and perhaps showing the PR would
> be *just fine.*
>
> When reviewing I try and find:
>
>
>    1. An example of a file that can be fixed:
>    https://github.com/JamesLMilner/terra-draw/blob/main/src/store/store.spec.ts
>    This file does not have a header - do you expect it to?
>
>    2. An example of a check from another project (this is a MIT project
>    that recently became a community project):
>
>    https://github.com/microsoft/torchgeo/blob/main/torchgeo/datasets/agb_live_woody_density.py
>
>    An example of a js file from another community project:
>    https://github.com/mapcentia/vidi/blob/master/public/js/gc2/gc2table.js
>
>
> Does that help?
>
> Also a question for you as an MIT project... do you consider the MIT
> license as applying to the documentation?
> https://github.com/JamesLMilner/terra-draw/tree/main/docs
>
> Some project choose a CC license?
> https://chooser-beta.creativecommons.org/
>
>    - CC0 or CC BY 4.0 is close in spirit to MIT allowing writers to remix
>    the documentation into their own work
>    - CC BY-SA 4.0 is close in spirit to GPL (copyleft approach must
>    retain license)
>    - MIT ... um ... consider the documentation source code (imply that
>    authors need to cite / quote your work like a book)
>
>
> Also many thanks :)
> - -
> Jody Garnett
>
>
> On Sep 16, 2024 at 10:39:08 AM, James Milner <jamesmilner22 at hotmail.com>
> wrote:
>
> Hi Jody,
>
> Hope you're well. Thanks for raising this - I wasn't sure if it was needed
> for me to respond here or Nick, but can you clarify what you mean by file
> headers in this situation? Terra Draw is MIT licensed and the released
> library does not currently have any runtime dependencies (we do have some
> development time dependencies). In addition we do adapt some code from the
> MIT licensed Turf.js project and we call this out at the start of files
> where it happens. I just raised a PR that standardises and clarifies those
> acknowledgements a bit better.
>
> Let me know if I can do anything else I can do to ensure this requirement
> is met.
>
> Many thanks,
>
> James
>
> ------------------------------
> *From:* Incubator <incubator-bounces at lists.osgeo.org> on behalf of Jody
> Garnett via Incubator <incubator at lists.osgeo.org>
> *Sent:* 10 September 2024 16:02
> *To:* Nick Bearman <nick at nickbearman.com>
> *Cc:* incubator at lists.osgeo.org <incubator at lists.osgeo.org>
> *Subject:* Re: [Incubator] Motion: Project Terra Draw community project
> initative
>
> You can propose Nick,
>
> I think Regina just went over the checklist
> <https://wiki.osgeo.org/wiki/Incubation_Committee#Step_1:_Add_OSGeo_Website_Project_Page> for
> website page?
>
> For the osgeo community project checklist
> <https://wiki.osgeo.org/wiki/Incubation_Committee#Step_2:_Join_OSGeo_Community_Projects_Initiative>
> ...
>
> I am especially interested in conforming that Terra Draw has gone through
> their file headers (this is the first step of the code providence review
> that takes such a long time in incubation).
>
> Context: For the website we ask that they choose a license. To be
> community project we ask that they check that it is applied correctly.
>
>
> - -
> Jody Garnett
>
>
> On Sep 10, 2024 at 8:12:19 AM, Nick Bearman via Incubator <
> incubator at lists.osgeo.org> wrote:
>
> (I think I can formally propose this, tell me if I am wrong and it should
> be Jody as Chair!)
>
>
> I would like to make the following motion:
>
> > Motion to include Terra Draw project in OSGeo community initiative
>
> The repository is here https://github.com/JamesLMilner/terra-draw and
> meets our OSGeo
> community initiative checklist (thanks Regina)
>
> The motion is held open for two weeks until 24th September.
>
>
> Angelos Tzotsos
> Arnulf Christl
> Bob (CI-StPaul) Basques
> Brian M Hamlin
> Daniel Morissette
> Dimitris Kotzinos
> Frank Warmerdam
> Jo Cook
> Jody Garnett (chair)
> Michael Smith
> Nick Bearman
> Regina Obe (+1 from 28th Aug)
> Steve Lime
> Tom Kralidis
>
>
> Best wishes,
> Nick.
>
>
> On 30/08/2024 10:10, James Milner via Incubator wrote:
>
> Hey Jody and Regina,
>
> Thanks both for getting back to me with the review. Apologies, I probably
> could have been a bit more detailed in my original email after viewing some
> of the other email applications! I followed the instructions provided, it
> was all very clear no real feedback except I missed where to upload the
> 'framed screenshot' image but figured it out eventually. The template
> images were really helpful with the correct dimensions and layouts needed.
>
> I would actually say the more complicated part, and maybe I missed
> something here, was the initial process of getting here. I was mostly
> following instructions for Incubation Committee - OSGeo
> <https://wiki.osgeo.org/wiki/Incubation_Committee#Step_1:_Add_OSGeo_Website_Project_Page> rather
> than Add a Project - OSGeo
> <https://www.osgeo.org/community/getting-started-osgeo/add-a-project/> which
> may have confused things slightly, as it took me a while to figure out how
> to sign up for an OSGeo ID then get the mantra, then also sign up for the
> mailing list. Maybe the wiki should just link to the OSGeo Add a Project
> page rather than having two 'sources of truth' so to speak? I also wonder
> if the OSGeo signup process could be simplified to use some sort of
> automated CAPTCHA rather than emailing the mantra? Hope this is helpful
> feedback.
>
> I have submitted the Terra Draw project for review, let me know if there
> are any adjustments to make.
>
> All the best,
>
> James
>
> ------------------------------
> *From:* Jody Garnett <jody.garnett at gmail.com> <jody.garnett at gmail.com>
> *Sent:* 28 August 2024 20:47
> *To:* Regina Obe <lr at pcorp.us> <lr at pcorp.us>
> *Cc:* James Milner <jamesmilner22 at hotmail.com> <jamesmilner22 at hotmail.com>;
> incubator at lists.osgeo.org <incubator at lists.osgeo.org>
> <incubator at lists.osgeo.org>
> *Subject:* Re: [Incubator] Terra Draw
>
> Seems good, thanks for your application James and review Regina.
>
> James I would really *love* your feedback on the new "Add a project
> <https://www.osgeo.org/community/getting-started-osgeo/add-a-project/>"
> instructions. Easy feedback like typos, but most importantly and confusion
> or questions you have.
>
> I have added "project author" to your profile.
> - -
> Jody Garnett
>
>
> On Aug 28, 2024 at 1:28:31 PM, Regina Obe <lr at pcorp.us> wrote:
>
> +1 looks okay to me.
>
>    1. I see license file
>    2. contributing file
>    3. getting started guides -
>    https://github.com/JamesLMilner/terra-draw/blob/main/guides/1.GETTING_STARTED.md
>    4. Many releases
>    5. Healthy number of contributors
>
>
>
> @Jody Garnett <jody.garnett at gmail.com> any concerns?
>
>
>
>
>
> *From:* Incubator <incubator-bounces at lists.osgeo.org> *On Behalf Of *James
> Milner via Incubator
> *Sent:* Wednesday, August 28, 2024 2:54 PM
> *To:* incubator at lists.osgeo.org
> *Subject:* [Incubator] Terra Draw
>
>
>
> Incubation committee:
>
>
>
> I would like to ask permission to list my project "Terra Draw" on the
> OSGeo website in order to share my work with the community.
>
>
>
> Terra Draw is a JavaScript library which allows for drawing and editing of
> geometries on maps. It works with a selection of different mapping
> providers, including Leaflet, MapLibre and OpenLayers and has been going
> for over 2 years now and I am eager to help more people use it.
>
>
>
> The repository is located here:
> https://www.github.com/JamesLMilner/terra-draw and is released under the
> MIT license
>
>
>
> My OSGeo userid is "jameslmilner" and I will need permission to create a
> project page.
>
>
>
> Many thanks,
>
> James
>
>
> _______________________________________________
> Incubator mailing listIncubator at lists.osgeo.orghttps://lists.osgeo.org/mailman/listinfo/incubator
>
> --
> Nick Bearman
> +44 (0) 7717745715nick at nickbearman.com - New email address!
>
> Please let me know if I can make any adjustments related to disability or neurodivergence to improve how we interact.
>
> Due to my own life/work balance, you may get emails from me outside of normal working hours. Please do not feel any pressure to respond outside of your own working pattern.
>
> _______________________________________________
> Incubator mailing list
> Incubator at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/incubator
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/incubator/attachments/20240919/23d5adeb/attachment-0001.htm>