Skip to content

docs: encourage community patches #3794

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 9, 2025

Conversation

aldy505
Copy link
Collaborator

@aldy505 aldy505 commented Jul 8, 2025

Hopefully this will provide a better guide on how to create patches.

Hopefully this will provide a better guide on how to create patches.
Copy link

codecov bot commented Jul 8, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.45%. Comparing base (e2ad04d) to head (7a29cf9).
Report is 1 commits behind head on master.

✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #3794   +/-   ##
=======================================
  Coverage   99.45%   99.45%           
=======================================
  Files           3        3           
  Lines         183      183           
=======================================
  Hits          182      182           
  Misses          1        1           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.


They should be run from the root directory. For example, the
`external-kafka` patches should be run as:
They should be run from the root directory. For example, the `external-kafka` patches should be run as:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we ensure patches work fine without conflicts as we change docker-compose.yml over time?

Maybe a GHA or something like that?

I'll whip up a PR if you're OK with it.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oops! I just saw #3793 :)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done that here #3793

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, anyway, I was thinking of mentioning that there will be a CI job that runs weekly, if a patch is broken, it will create a new github issue, and I'll alert the original patch author.

Copy link
Member

@BYK BYK left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The patch looks good. Two notes:

  1. We may want to invest in an actual plug-in system as patch files won't be easy to maintain
  2. These docs are getting longer so might be deserving their own spot on self-hosted docs now?

@aldy505
Copy link
Collaborator Author

aldy505 commented Jul 9, 2025

  1. We may want to invest in an actual plug-in system as patch files won't be easy to maintain

I'd prefer to go with this current route first, then if we have enough interest, we may move into a plugin system. Currently I have no idea on how it looks like if you need to modify the docker compose and everything.

  1. These docs are getting longer so might be deserving their own spot on self-hosted docs now?

Honestly it's harder for me to get things merged on the docs rather than on self-hosted.

@BYK
Copy link
Member

BYK commented Jul 9, 2025

Honestly it's harder for me to get things merged on the docs rather than on self-hosted.

Not if you ping me for this.

@aldy505 aldy505 merged commit 0c63bec into master Jul 9, 2025
14 checks passed
@aldy505 aldy505 deleted the aldy505/docs/encourage-community-patches branch July 9, 2025 23:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

3 participants