In order to build and test your changes, simply run ./scripts/develop.

Documentation is generated from the sql files, using the script scripts/documentaion (requires poetry).

Release Process

  1. Update version number
    • Don't follow semver, simply use major and minor from H3 core and increment patch.
    • Version number should be changed in h3.control, h3_postgis.control and META.json.
    • Update files suffixed --unreleased should be renamed.
    • Installer .sql files should have @ availability comments updated.
    • Create new update files with --unreleased suffix.
    • Update changelog by moving from Unreleased to a new section
  2. Create a release on GitHub
    • Draft new release "vX.Y.Z"
    • Copy entry into release description
  3. Distribute the extension on PGXN
    • Run make dist to package the release
    • Upload the distribution on PGXN Manager (username: bytesandbrains)
  4. Revert version numbers in h3.control, h3_postgis.control and META.json to unreleased