This repository is for holding discussions about the carbon.txt syntax and specification.
To see the most recently published carbon.txt syntax visit https://carbontxt.org/.
If you would like to collaborate with us on improving this syntax, this is the place for you! Head to this repo's issues section to share your ideas.
If you've come here looking for something else, hop to the "I came looking for" section.
carbon.txt makes sustainability data easier to discover and use on the web. Carbon.txt is a single place to look on any domain – /carbon.txt – for public, machine-readable, sustainability data relating to that company.
It’s a web-first, connect not collect style approach, of most benefit to those interested in scraping the structured data companies have to publish according to national laws. Designed to be extended by default, we see carbon.txt becoming essential infrastructure for sustainability data services crunching available numbers and sharing the stories it can tell.
Visit the Green Web Foundation website for a full overview.
See the Green Web Foundation website.
There are a number of places where we hold technical documentation for this project. The best starting point to find what you're looking for is on https://carbontxt.org/.
The issues sections of our main github repos is also a great source of help. You might find someone has already asked for help on the same issue and you’ll find an answer. We appreciate those that take the time to create public issues for this reason, it may help someone who encounters something similar after you.
Technical issues can cover a broad range of things. We take this to mean:
- Reporting a bug or something not working as you expect.
- Suggesting a new feature or improvement that could be made.
Our project GitHub repos are generally the best place to raise technical issues like these. We have a number of repos that cover different aspects of our project. Here’s a summary of those and a link to the relevant issues part of that repo:
Using the carbon.txt validator tools on our public website - https://github.com/thegreenwebfoundation/carbon-txt-site/issues
Extending the carbon.txt approach such as running your own validator service or creating plugins - https://github.com/thegreenwebfoundation/carbon-txt-validator/issues
Developing the carbon.txt syntax and specification (this repository) - https://github.com/thegreenwebfoundation/carbon.txt/issues
If you are unsure of the best repo for your issue, please just make your best guess. We'll move it if we think it necessary.
If you need help with a specific technical issue, our technical documentation is there to help. If you need can't find what you're looking for consider raising an issue.
If that doesn't feel right for any reason or you would value a private conversation, please use the Green Web Foundation support form.
We really welcome community feedback on ideas we are looking to move forward, or ideas that have come from others in the community. The best place for this is in the issues section of our three main github repositories as explained above.
We are always open for discussions about how people can contribute back to the development and success of this tool through collaboration or financial donations. Please use the Green Web Foundation support form to let us know what you’d like to chat about.