Skip to content

Add funding.json and .well-known/funding-manifest-urls#6275

Closed
Robot8A wants to merge 5 commits into
openstreetmap:masterfrom
Robot8A:funding.json
Closed

Add funding.json and .well-known/funding-manifest-urls#6275
Robot8A wants to merge 5 commits into
openstreetmap:masterfrom
Robot8A:funding.json

Conversation

@Robot8A
Copy link
Copy Markdown
Member

@Robot8A Robot8A commented Jul 31, 2025

Added funding.json and well-known files, for describing OSM's fundraising options.
This would allow OSM to apply for FLOSS/fund funding.

I added OSM (database) as the sole project. An alternative arrangement would be to describe the different software projects that form the OSM Core software, with its associated licenses.

@tomhughes
Copy link
Copy Markdown
Member

Who has verified/signed off on all this exactly? Financial details have presumably been checked with the treasurer? Have MWG checked the details of the membership tiers?

Note sure how @Firefishy will feel about continuing to promote the bitcoin address...

@tomhughes
Copy link
Copy Markdown
Member

Thinking about it this will probably have to be done via https://github.com/openstreetmap/chef/ and not here as we don't want other people running this code to be publishing this without realising.

Frankly the whole thing of publishing a JSON document nobody will ever read seems weird and I have to wonder about an organisation that requires it to consider applications...

@danieldegroot2
Copy link
Copy Markdown
Contributor

danieldegroot2 commented Jul 31, 2025

Who has verified/signed off on all this exactly? Financial details have presumably been checked with the treasurer? Have MWG checked the details of the membership tiers?

Part of OSMF Board Meeting 2025-07-31: Potential funding source - FLOSS/fund by Zerodha
(pending Dorothea to add results from meeting)
for information only; I personally do not know if it is approved yet.

Suggested grischard, via private message, to review this PR (assuming it is approved).
He replied saying it is okay to let Hector continue with this.

See also Sharing funding opportunities for development and OSMF, 2025 fundraising drive

Not sure how @Firefishy will feel about continuing to promote the bitcoin address...

Up to OSMF's willingness to keep it.

Thinking about it this will probably have to be done via https://github.com/openstreetmap/chef/ and not here as we don't want other people running this code to be publishing this without realising.

Frankly the whole thing of publishing a JSON document nobody will ever read seems weird and I have to wonder about an organisation that requires it to consider applications...

Also, actual page could maybe be hosted at separate (temporary) domain (ie. GitHub Pages).
(though not sure if it will be accepted)
They can ask Grant about this.


Regarding the file, @Robot8A could ask them if needed

  • repositoryUrl do they prefer GitHub or similar?
    if so, they might allow to link to the organisation rather than single repository.

S: [...]github.com/openstreetmap

URL of the repository where the project's source code and other assets are available.

  • licenses do they prefer (also) codebase licenses (when it is not solely a database)? Anyhow, it seems they suggest some formatting

The project's licenses (up to 5). For standard licenses, use the license ID from the SDPX index prefixed by "spdx:". eg: "spdx:GPL-3.0", "spdx:CC-BY-SA-4.0"

S: ie. spdx:ODbL-1.0 (ref https://spdx.org/licenses/ ); assuming it is sufficient.

  • history empty; optional, so might be redundant.

Otherwise seems to be quoted text; someone else could look at the specification if it is incomplete / requires modifications.


Sidenotes:

@Firefishy
Copy link
Copy Markdown
Member

Firefishy commented Aug 1, 2025

I'm ok with the bitcoin donation option remaining. I discussed it with board members. I will only convert BTC to EUR/GBP when the balance justifies the work involved.

@Firefishy
Copy link
Copy Markdown
Member

I can move this across to the Chef repo if desired.

@Robot8A
Copy link
Copy Markdown
Member Author

Robot8A commented Aug 1, 2025

I made some fixes to pass the https://dir.floss.fund/validate validation tool.
These are:

  • Change descriptions to less than 500 characters
  • Have well-known URLs have the same hostname as the project/organization/repo URL

As well, I fixed:

  • License namespace
  • Added GH Sponsorship

@Robot8A
Copy link
Copy Markdown
Member Author

Robot8A commented Aug 1, 2025

I agree that we may not have planet as the repo url, but I am also not sure about having the github url, that would be if we decide listing the different software repos as projects instead of just one project, being the database.

I agree on moving this PR to the Chef repo.

@Firefishy Firefishy self-assigned this Aug 7, 2025
@Firefishy Firefishy marked this pull request as draft August 7, 2025 09:15
@Robot8A
Copy link
Copy Markdown
Member Author

Robot8A commented Aug 8, 2025

In today's EWG call, we agreed to keep it as one project, but add github.com/openstreetmap as repositoryUrl, as suggested by @danieldegroot2.
@Firefishy, should I make the changes here or after moving to the Chef repo?

@Firefishy
Copy link
Copy Markdown
Member

In today's EWG call, we agreed to keep it as one project, but add github.com/openstreetmap as repositoryUrl, as suggested by @danieldegroot2. @Firefishy, should I make the changes here or after moving to the Chef repo?

Here would be good. Easier for me to then more it once done.

Comment thread public/funding.json Outdated
"url": "https://planet.openstreetmap.org",
"wellKnown": "https://planet.openstreetmap.org/.well-known/funding-manifest-urls"
"url": "https://github.com/openstreetmap/",
"wellKnown": "https://github.com/openstreetmap/chef/tree/master/cookbooks/web/files/default/static/.well-known/funding-manifest-urls"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should be hosting this file, not relying on github. Additionally, it's unlikely that this URL will meet the format required, as it's not the URL of the file, it's a URL for a web page showing the github interface.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can create a URL that points at the raw file but that isn't it and in any case it's daft to put a file in the chef repo just so we can point at it on github... As @pnorman says we should host it ourselves.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can point it to the raw file if that is better. If we put a URL where the host doesn't coincide with the repository URL, the validator fails, so if we add the GitHub page as the repo URL, it has to point to GitHub.
See OpenRefine/openrefine.org#466 for an example

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The spec says the repositoryUrl wellKnown is

Optional. Required if the above url and the URL of the funding.json manifest do not have the same hostname. Starts with https:// or http://. Max len 250.

This is the exact same as the webpageUrl wellKnown.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed now

Comment thread public/funding.json
"description": "OpenStreetMap is an initiative to create and provide free geographic data, such as street maps, to anyone.\nOpenStreetMap is built by a community of mappers that contribute and maintain data about roads, trails, cafés, railway stations, and much more, all over the world.",
"webpageUrl": {
"url": "https://www.openstreetmap.org",
"wellKnown": "https://www.openstreetmap.org/.well-known/funding-manifest-urls"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't required because the above URL and the funding.json manifest have the same hostname: www.openstreetmap.org

Comment thread public/funding.json Outdated
"description": "The OpenStreetMap Foundation is a not-for-profit organization that supports the OpenStreetMap Project. The OpenStreetMap Project based at OpenStreetMap.org, is the worldwide mapping effort that includes over two million volunteers around the globe.\n\nThe foundation consists of members from around the world who elect its board of directors.\n\nMuch of the foundation’s extensive work is done in the background, yet is critical to the ongoing functioning and growth of the OpenStreetMap Project.\n\nThe foundation supports the project with several key functions:\n\n* As a UK-registered limited company, the foundation acts as a legal entity for the OpenStreetMap Project.\n* The foundation is the custodian for the computer servers and services necessary to host the OpenStreetMap project.\n* Provides a vehicle for fund-raising to support the project. The foundation can accept donations for the OpenStreetMap Project and allocate those donations to OpenStreetMap Project activities.\n* Organizes the annual conference, State-of-the-map\n* Supports and communicates with the working groups, such as communications, licensing, etc. The foundation board at times will delegate various tasks to working groups, such as public relations, Web site development, etc.\n\nOpenStreetMap is an open initiative to create and provide free map data to anyone who wants them.",
"webpageUrl": {
"url": "https://osmfoundation.org",
"wellKnown": "https://osmfoundation.org/.well-known/funding-manifest-urls"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will require changes to the osmfoundation.org site as well if we're putting the well-known there.

This wellKnown property is not required because it is the same hostname as the URL above.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed now

@gravitystorm
Copy link
Copy Markdown
Collaborator

I can move this across to the Chef repo if desired.

@Firefishy yes please. It's not something that we can review/merge/close here, so if you can move it out of our queue that would be great.

@Robot8A
Copy link
Copy Markdown
Member Author

Robot8A commented Sep 22, 2025

If you all agree, I believe it is now ready to move to the Chef repo

@Firefishy
Copy link
Copy Markdown
Member

This PR can now be closed as I've opened the replacement: openstreetmap/chef#799

@tomhughes tomhughes closed this Oct 6, 2025
@Robot8A
Copy link
Copy Markdown
Member Author

Robot8A commented Oct 20, 2025

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants