references.md

Nix references and other useful tools:

• Zero to Nix: Start here to get your feet wet with how Nix works, and how to use Nixpkgs: https://zero-to-nix.com/
• nix-installer: My recommended way to install Nix
  • https://github.com/DeterminateSystems/nix-installer
• Nix manual https://nixos.org/manual/nix/stable/
  • Useful primarily for option and command references
• Flake schema reference https://nixos.wiki/wiki/Flakes
  • Useful to know what flake.nix is referring to
• Example pull requests for this repo:
  • Adding smoke tests for an extension: supabase/nix-postgres#2
  • Extension smoke tests, part 2: supabase/nix-postgres#3
  • Adding an extension and a smoke test at once: https://github.com/supabase/nix-postgres/pull/4/files
  • Updating an extension to trunk: supabase/nix-postgres#7
  • Updating an extension to the latest release: supabase/nix-postgres#9
• Contributing to nixpkgs
  • Adding a PGRX-powered extension: NixOS/nixpkgs#246803
  • Adding a normal extension: NixOS/nixpkgs#249000
  • Adding new PostgreSQL versions: NixOS/nixpkgs#249030
• NixOS Discourse: https://discourse.nixos.org/
  • Useful for community feedback, guidance, and help
• nix-update: https://github.com/Mic92/nix-update
  • Used in this repository to help update extensions
• pgTAP for testing: https://pgtap.org/documentation.html