Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Augment contributing docs

Aperta
  • Qualcosa non va?
#558 4 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
35/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
postgresql, rust, supabase
Ambito
databases, developer-experience, documentation

Direzione di ricerca

Inizia con la documentazione esistente per i contributi e il README, quindi esamina gli argomenti richiesti relativi alla configurazione locale, ai test, al debugging e al release/build. Verifica quali sezioni richieste sono già coperte e documenta i workflow rimanenti per i contributor, incluso come le patch unite raggiungono Supabase; il lavoro è completo quando la documentazione per i contributi è collegata dal README e risponde alle domande elencate dei contributor.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

While the package is well-written, easy to navigate, and well-documented for package consumers, the contributing docs could be augmented with additional details, tips, and tricks for people who want to become productive contributors more quickly.

Rationale

While the package is excellent, its feature set is lagging behind some competitors like Hasura. Ideally, documentation improvements would reduce the barrier to entry for the community to get involved and can help encourage more community PRs for patches and new features. Leaning on the community more can foster engagement and buy-in in the ecosystem and lead to a faster release cycle.

Additionally, while it's clear the maintenance team is dedicated to the success of the package, it also seems that the team is spread fairly thin. Delegating more development to the community will give the maintainers the ability to set high-level vision and architectural goals while improving overall throughput.

Design

  • add additional platform-agnostic details on getting up and running locally, with recommendations for spinning up local databases that play well with common workflows outside of pg_graphql maintenance
  • add guides for creating and validating net new tests, including tips on generating output snapshots for use in tests
  • add local development workflow recommendations, especially with tips on debugging and assessing changes locally
  • add a link to the contributing docs in the readme
  • add a comprehensive releases and builds section so people know what to expect if they either want to do the work to create a release or, if they're willing to wait, what they should be looking for in the code to check the progress of the release (including in platforms like supabase)

Links to external resources are fine. The idea is not to rewrite docs for how to use cargo, rust, pgrx, postgres, etc. However, starting with the assumption that maintainers may be unfamiliar with one or more tools and pointing people in the right direction regarding the most important steps could improve ramp-up times.

Examples

  • I have run queries locally and have manually validated the expected output, how can I quickly develop a snapshot of the outputs for use in tests?
  • I have made some changes to the code, but I would like to validate some assumptions. How can I debug the changes? Is print statement debugging possible?
  • I made a patch that got merged in. What needs to happen for me to be able to use it in supabase?

Drawbacks

  • Good docs take time, time which puts other features on the back-burner.
  • There are no guarantees that the docs will be used in any meaningful way.

Alternatives

  • Do nothing, expect contributors to be savvy enough to get up and running on their own. This isn't unreasonable and should be a baseline expectation.

Unresolved Questions

  • Are there common issues would-be contributors often encounter that prevents them from contributing?
  • Are there other known documentation improvements that can be added?
Lingua principale
Rust
Stelle
3.4k
Fork
143
Merge medio
4h 47m
PR unite (30g)
2

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di supabase/pg_graphql

Tutte le issue di supabase/pg_graphql

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.