Proposed Collaboration Structure for JavaScript and Python Implementations

Welcome "Vincenzo Gambino" @vincenzo-gambino as co-maintainer of "drupal_jsonapi_params" for Python library support.

The goal is to use this Drupal.org project as an umbrella project for the
drupal-jsonapi-params ecosystem while allowing each implementation
to continue development in the platform and ecosystem most suitable for it.

Current Situation

• The JavaScript / TypeScript implementation is maintained on GitHub and published to npm.
• A new Python implementation for FastAPI and related Python projects is now available and published to PyPI.
• The Drupal.org project is currently mainly used for discoverability, issue credits, and visibility within the Drupal ecosystem.

Proposed Structure

• Keep a single Drupal.org project as the umbrella project for all drupal-jsonapi-params implementations.
• Continue maintaining language-specific implementations in their own repositories:
  • JavaScript / TypeScript → GitHub + npm
  • Python → GitHub + PyPI
• Add links on the Drupal.org project page to both implementations and document installation instructions for each ecosystem.
• Use Drupal.org primarily for:
  • Project discovery within the Drupal ecosystem
  • Issue credits and contribution attribution
  • Cross-language or umbrella discussions

Issue Management

To avoid fragmentation and to keep issue management comfortable for developers in each ecosystem:

• JavaScript-specific issues should be tracked in the JavaScript GitHub repository.
• Python-specific issues should be tracked in the Python GitHub repository.
• Drupal.org issues can still be created for:
  • Contribution credit attribution
  • Cross-project discussions
  • Drupal ecosystem visibility

Drupal.org Git Repository

The Drupal.org GitLab repository can remain lightweight and primarily contain documentation, links, and references to the language-specific repositories.

Advantages of This Approach

• Single recognizable project within the Drupal ecosystem
• Shared branding and discoverability
• Native developer experience for each language ecosystem
• Simpler contribution workflows
• Flexibility to split into separate Drupal.org projects later if necessary

At the moment, keeping both implementations under one umbrella project seems to provide the best balance between visibility, maintainability, and contributor experience.

References:

- GitHub repo for TypeScript Project: https://github.com/d34dman/drupal-jsonapi-params
- npm package : https://www.npmjs.com/package/drupal-jsonapi-params
- GitHub repo for Python Project: https://github.com/VincenzoGambino/drupal-jsonapi-params-python
- PyPI package: https://pypi.org/project/drupal-jsonapi-params/