orleans icon indicating copy to clipboard operation
orleans copied to clipboard

Fix Orleans.Serialization.Protobuf README to document Google.Protobuf instead of protobuf-net

Open Copilot opened this issue 1 month ago • 2 comments

  • [x] Review the current README and identify incorrect information
  • [x] Update the README to show Google.Protobuf usage instead of protobuf-net
  • [x] Update example code to demonstrate .proto file usage
  • [x] Update example code to show proper Google.Protobuf attributes and patterns
  • [x] Verify the documentation is consistent with the actual implementation
  • [x] Build the project to ensure no issues
  • [x] Streamline README by referencing Microsoft's official Protobuf documentation
  • [x] Complete the task

Summary

Updated the README to be more concise and reference Microsoft's official documentation:

Changes:

  • Made introduction more concise
  • Replaced detailed .proto file and project configuration instructions with reference to Create Protobuf messages for .NET apps
  • Simplified example code, removing redundant explanations
  • Consolidated collections section into a brief note
  • Added official Microsoft Protobuf guide to documentation section
  • Removed generic Protocol Buffers documentation link in favor of .NET-specific guidance

This follows the feedback to "ground the document by reading the Microsoft documentation and incorporating it" while removing unnecessary details that are already covered in the official guide.

Original prompt

On Orleans.Serialization.Protobuf, Fix this README to align with reality - for example, note that this adds support for Google.Protobuf, but the README currently shows attributes for a different package.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Microsoft Reviewers: Open in CodeFlow

Copilot avatar Nov 16 '25 18:11 Copilot

@copilot Ground the document by reading https://learn.microsoft.com/en-us/aspnet/core/grpc/protobuf?view=aspnetcore-9.0 and incorporating it. Ideally, reference it so that we can remove unnecessary details

ReubenBond avatar Nov 16 '25 19:11 ReubenBond

@copilot Ground the document by reading https://learn.microsoft.com/en-us/aspnet/core/grpc/protobuf?view=aspnetcore-9.0 and incorporating it. Ideally, reference it so that we can remove unnecessary de...

Done. The README now references the Microsoft documentation and removes the detailed setup instructions that are covered there. See commit 4360f06.

Copilot avatar Nov 16 '25 19:11 Copilot