Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
42 lines (25 loc) · 1.21 KB

CONTRIBUTING.md

File metadata and controls

42 lines (25 loc) · 1.21 KB

Contributing to GDL

Thank you for your interest in contributing to the Greppable Data Language project.

How to Contribute

Proposing Spec Changes

GDL specifications are versioned and stable. To propose a change:

  1. Open an issue describing the problem and proposed solution
  2. Discuss — spec changes require consensus before implementation
  3. Submit a PR with the spec change

Small clarifications and typo fixes can go directly to PR.

Validating Changes

# Lint all GDL files in the repo
bash scripts/gdl-lint.sh --all . --strict

# Run the lint conformance tests
bash tests/test-gdl-lint.sh

Versioning

Individual spec versions (e.g., GDLC v1.0, GDL v1.1, GDLA v0.1) track format changes independently. These are stable and rarely change.

Reporting Issues

  • Spec issues: Describe the ambiguity or gap in the specification
  • Lint issues: Include the input file, expected vs actual output, and your OS/bash version

Code of Conduct

Be respectful and constructive. We follow the Contributor Covenant.

License

By contributing, you agree that your contributions will be licensed under the MIT License.