Skip to content

docs: fix org-less links, wrong artifact badges, stale class/package names, and Maven Central claim - #248

Open
ZayanKhan-12 wants to merge 5 commits into
salesforce:masterfrom
ZayanKhan-12:docs/fix-readme-drift
Open

docs: fix org-less links, wrong artifact badges, stale class/package names, and Maven Central claim#248
ZayanKhan-12 wants to merge 5 commits into
salesforce:masterfrom
ZayanKhan-12:docs/fix-readme-drift

Conversation

@ZayanKhan-12

Copy link
Copy Markdown

Five commits, all documentation (six .md files):

  1. CONTRIBUTING.md — the Issues links (github.com/grpc-java-contrib/issues) are missing the salesforce/ org segment and 404; the in-page anchors used #creating_a_pull_request where GitHub slugs the heading with hyphens.
  2. grpc-testing-contrib README — both badges referenced the grpc-contrib artifact instead of this module's grpc-testing-contrib (published on Central — verified), and the documented @Rule class is GrpcContextRule; no GrpcContext class exists in the module.
  3. All module READMEsmaven-badges.herokuapp.com badge images have returned 404 since the Heroku free-tier shutdown; replaced with shields.io badges (verified 200) linking to central.sonatype.com.
  4. grpc-contrib README — removed the session subpackage bullet; the module's subpackages are context, instancemode, interceptor, and xfcc.
  5. Root README — dropped "you will have to clone this repo and build it yourself… deploying to Maven Central is still in our future": the com.salesforce.servicelibs artifacts are published on Maven Central (javadoc.io/Central verified).

Verification: class/package names checked against the source tree; artifact availability and badge URLs curl-verified. mvn test cannot complete on this machine on unmodified master either — the protobuf plugin requires a jprotoc:exe:osx-aarch_64 protoc plugin binary that was never published for Apple Silicon (identical failure with and without this diff, which touches only markdown).

Prepared with AI assistance (Claude).

zk-khan and others added 5 commits July 26, 2026 20:15
github.com/grpc-java-contrib/issues is missing the salesforce org
segment and 404s; the anchors used underscores where GitHub slugs the
'Creating a Pull Request' heading with hyphens.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The badges referenced the grpc-contrib artifact rather than this
module's grpc-testing-contrib (published on Central; verified), and the
documented @rule class is GrpcContextRule - no GrpcContext class exists
in the module.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
maven-badges.herokuapp.com returns 404 since the Heroku free-tier
shutdown; use shields.io Maven Central badges linking to
central.sonatype.com.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The module's subpackages are context, instancemode, interceptor, and
xfcc; no session package exists.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
com.salesforce.servicelibs artifacts (grpc-contrib, grpc-spring,
grpc-testing-contrib, jprotoc) are published on Maven Central; the
'clone and build it yourself' guidance predates that.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@salesforce-cla

Copy link
Copy Markdown

Thanks for the contribution! Before we can merge this, we need @zk-khan to sign the Salesforce Inc. Contributor License Agreement.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants