Skip to content

Conversation

@kallal79
Copy link

Summary

Fixes the confusing protoc-gen-go build instructions identified in #59.

Problem

The original instructions incorrectly mixed protoc installation with protoc-gen-go plugin installation, referencing non-existent versions.

Solution

  • Clear separation of protoc binary vs Go plugin installation
  • Fixed non-existent protobuf-all-[VERSION].tar.gz references
  • Added working installation commands with correct versions
  • Added comprehensive troubleshooting section
  • Maintained cross-platform compatibility

Files Modified

  • docs/demo/cca/manual-end-to-end.md
  • docs/demo/psa/manual-end-to-end.md

Testing

  • All demo test cases validated and working
  • Installation verification steps added
  • No impact on existing functionality

Closes #59

…aison#59)

Clarify the distinction between protoc and protoc-gen-go installation:
- protoc is the Protocol Buffer compiler
- protoc-gen-go is the Go language plugin for protoc
- Both are required for generating Go code from .proto files

Updated both CCA and PSA demo documentation to provide clear,
platform-specific installation instructions with troubleshooting guidance.

Fixes veraison#59

Signed-off-by: 7908837174 <[email protected]>
@kallal79 kallal79 force-pushed the fix-protoc-installation-instructions-issue-59 branch from eb2618d to 02ca03a Compare September 20, 2025 08:54
Copy link
Contributor

@setrofim setrofim left a comment

Choose a reason for hiding this comment

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

LGTM

@kallal79
Copy link
Author

kallal79 commented Oct 2, 2025

Thanks @setrofim for the approval Kindly requesting a review from @yogeshbdeshpande as well.

@yogeshbdeshpande
Copy link
Contributor

@7908837174 Have you tried on a clean machine the modified instructions to validate the flow for correctness..?

Copy link
Contributor

@yogeshbdeshpande yogeshbdeshpande left a comment

Choose a reason for hiding this comment

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

LGTM!

@kallal79
Copy link
Author

kallal79 commented Oct 2, 2025

@7908837174 Have you tried on a clean machine the modified instructions to validate the flow for correctness..?

Yes — the updated bash instructions were successfully tested on a clean Ubuntu system, confirming full toolchain setup, PATH resolution, and demo execution without inherited configs.

@yogeshbdeshpande yogeshbdeshpande merged commit 0763750 into veraison:main Oct 2, 2025
1 check passed
@kallal79
Copy link
Author

kallal79 commented Oct 2, 2025

Kindly requesting review from sir @yogeshbdeshpande for PR veraison/services#344

@kallal79
Copy link
Author

kallal79 commented Oct 2, 2025

Big thanks to @setrofim and @yogeshbdeshpande for your thoughtful reviews and support on PR #64 ..

@kallal79 kallal79 deleted the fix-protoc-installation-instructions-issue-59 branch October 2, 2025 18:34
@yogeshbdeshpande
Copy link
Contributor

Thanks to you @7908837174 for working hard on issues and fixing the same!

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

protoc-gen-go build instructions for CCA demo are confusing

3 participants