mirror-godotengine/godot-interactive-changelog
1
0
Fork 0
mirror of https://github.com/godotengine/godot-interactive-changelog.git synced 2025-12-10 05:51:10 +03:00
Code Issues Projects Releases Packages Wiki Activity
Mirror of godotengine/godot-interactive-changelog
203 commits 2 branches 0 tags 57 MiB
Find a file
Exact
Rémi Verschelde 94e3347444
 Merge pull request #33 from Calinou/compose-fetcher-use-https 
Use HTTPS in `compose-fetcher.js` to remove SSH authentication requirement
2025-12-10 01:46:04 +01:00
.github/workflows CI: Update actions to their latest versions 2025-02-04 15:25:39 +01:00
build Use HTTPS in compose-fetcher.js to remove SSH authentication requirement 2025-12-10 01:03:35 +01:00
configs Add config and data for 4.6-dev6 2025-12-05 10:44:16 -06:00
data Add config and data for 4.6-dev6 2025-12-05 10:44:16 -06:00
src Render inline code markup with code formatting (#21) 2025-02-04 15:20:04 +01:00
.editorconfig Extract the toolbar component, improve filtering/counting logic 2023-03-24 15:49:58 +01:00
.gitattributes Add .gitattributes 2024-11-05 09:14:25 -06:00
.gitignore Integrate GRAPHQL_TOKEN enhancements & checks 2025-06-26 10:27:50 -05:00
compose-db.js composedb: Reduce commits per page to 50 2025-11-10 14:02:13 +01:00
extract-hashes.py Add a script to fetch hashes of all publicly available downloads 2023-03-24 15:50:00 +01:00
LICENSE.md Initial commit 2023-03-21 17:37:03 +01:00
package-lock.json Run npm update 2025-11-10 13:51:44 +01:00
package.json Replace node-fetch by builtin Node fetch API 2025-11-10 13:48:24 +01:00
publish-db.js Pre-process PRs when publishing the database 2023-11-26 23:11:40 +01:00
README.md Replace node-fetch by builtin Node fetch API 2025-11-10 13:48:24 +01:00
rollup.config.js Add grouped mode and copy to clipboard to RN view 2023-10-25 23:04:59 +02:00

README.md

Godot Interactive Changelog

This project is provided for Godot Engine users and contributors to document in a complete and comprehensive manner changes that go into each release and developer preview of the engine. This project aims to largely remove the manual labor from creating and maintaining a project changelog, and provides tools to generate static information, such as CHANGELOG.md and release notes for the blog.

The benefit of this automated system is that it allows to track PRs as well as individual commits, preserving important context for the work that goes into each release. For example, it can also detect commits that were cherry-picked, and identify their original PRs.

Live website: https://godotengine.github.io/godot-interactive-changelog/

Contributing

This project is written in JavaScript and is built using Node.JS. HTML and CSS are used for the presentation. The end result of the build process is completely static and can be server from any web server, no Node.JS required.

Front-end is designed in a reactive manner using industry standard Web Components (powered by lit-element). This provides native browser support, and results in a small overhead from the build process.

To build the project locally you need to have Node.JS installed (12.x and newer should work just fine).

This project uses GitHub's GraphQL API. To fetch live data you need to generate a personal OAuth token. You can supply your token to the scripts using the GRAPHQL_TOKEN environment variable. Note, that if you don't have member access to the organization, you may not be able to access all the information used when generating the database.

Tip

For convenience, it's recommended to store the GRAPHQL_TOKEN environment variable in a .env file at the repository root.

Building the website

  1. Clone or download the project.
  2. From the project root run npm install or yarn to install dependencies.
  3. Run npm run build or yarn run build to build the pages.
  4. Run npm run publish-db or yarn run publish-db to prepare and copy configs and data.
  5. Serve the out/ folder with your method of choice (e.g. using Python 3: python -m http.server 8080 -d ./out).

rollup is used for browser packing of scripts and copying of static assets. The data fetching script is plain JavaScript with the Node fetch API.

Adding a new version

  1. Add a config file under the ./configs folder.
  • It must follow this format: <REPO_OWNER>.<REPO_NAME>.<VERSION>.json, e.g. godotengine.godot.1.2.3.json.
  1. Run npm run compose-db version:<VERSION> or yarn run compose-db version:<VERSION> to fetch the data from GitHub.
  • This project defaults to godotengine/godot, but you can also customize it with owner:<REPO_OWNER> and repo:<REPO_NAME>.
  • By default the repo is checked out to the ./temp folder, you can skip this step with skip-checkout.
  • GitHub API is very flaky and requests can fail from time to time due to the server-side issues; the compose script has a few tricks to mitigate that, but ultimately it can still randomly fail on bigger changelogs. Just run it again.
  1. Run npm run publish-db or yarn run publish-db to prepare and copy configs and data.

License

This project is provided under the MIT License.