Skip to content
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

examples: Added README files for all missing Examples #11676

Open
wants to merge 23 commits into
base: master
Choose a base branch
from

Conversation

vinodhabib
Copy link
Contributor

@vinodhabib vinodhabib commented Nov 8, 2024

As part of this PR added a new README files for all the examples with details and made consistency on directory structure for example-alts similar to other existing examples projects.

Fixes #5467

@vinodhabib vinodhabib marked this pull request as draft November 8, 2024 06:43
@vinodhabib vinodhabib marked this pull request as ready for review November 8, 2024 12:57
@vinodhabib vinodhabib marked this pull request as draft November 8, 2024 12:57
@vinodhabib vinodhabib changed the title examples: following the consistency for example-alts directory structure examples: GRPC Examples documentation and Consistency on directory structure changes Nov 11, 2024
@vinodhabib vinodhabib marked this pull request as ready for review November 11, 2024 12:36
examples/README.md Outdated Show resolved Hide resolved
examples/README.md Outdated Show resolved Hide resolved
examples/README.md Outdated Show resolved Hide resolved
@@ -135,6 +136,24 @@ before trying out the examples.

- [Keep Alive](src/main/java/io/grpc/examples/keepalive)
Copy link
Contributor

Choose a reason for hiding this comment

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

It is not clear to me which part of Sanjay Pujare's concerns this PR addresses.
"each example should have a README file which a user can read to understand the example." I don't find this done, for example there is no README for the subdirectories in https://github.com/grpc/grpc-java/tree/master/examples/src/main/java/io/grpc/examples.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@kannanjgithub @shivaspeaks There is a common README file for all the examples (which are inside the path https://github.com/grpc/grpc-java/tree/master/examples/src/main/java/io/grpc/examples) as mentioned in the below link and updated some of the missing ones with recent changes as part of this PR.

Common README link in grpc-java - https://github.com/grpc/grpc-java/blob/master/examples/README.md

Copy link
Contributor

Choose a reason for hiding this comment

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

The issue mentions "each example should have a README file which a user can read to understand the example." Merely enumerating the examples in the sub-directories to the parent README does not do that.

Copy link
Contributor Author

@vinodhabib vinodhabib Nov 19, 2024

Choose a reason for hiding this comment

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

I can see there are 21 examples, working on this comment and its in progress

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@kannanjgithub @shivaspeaks Added the Readme file with details for the all examples and its ready for Review. please have look once.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@kannanjgithub @shivaspeaks Added the Readme file with details for the all examples and its ready for Review. please have look once.

@kannanjgithub @shivaspeaks This PR is pending for review from long time, Request you have a look once.

@shivaspeaks shivaspeaks added the kokoro:run Add this label to a PR to tell Kokoro the code is safe and tests can be run label Jan 6, 2025
@grpc-kokoro grpc-kokoro removed the kokoro:run Add this label to a PR to tell Kokoro the code is safe and tests can be run label Jan 6, 2025
shivaspeaks

This comment was marked as off-topic.

Copy link
Member

@shivaspeaks shivaspeaks left a comment

Choose a reason for hiding this comment

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

Added some comments.

@ejona86
Copy link
Member

ejona86 commented Jan 7, 2025

I see this says Fixes #5467, and it mentions "directory structure" a few times. But I don't actually see it really changing the directory structure and I don't know what "GRPC Examples documentation" is communicating. The directory structure issue is that we have a mix of top-level examples and then example folders like example-alts.

@vinodhabib
Copy link
Contributor Author

vinodhabib commented Jan 8, 2025

I see this says Fixes #5467, and it mentions "directory structure" a few times. But I don't actually see it really changing the directory structure and I don't know what "GRPC Examples documentation" is communicating. The directory structure issue is that we have a mix of top-level examples and then example folders like example-alts.

@ejona86 Thanks for your reply, I was refering to one of the change as the "directory structure" for example-alts as it is not consistant with all the other examples projects directory so made this change/move as below in this PR apart from this no other changes related to directory structure.

image

"GRPC Example documentation" was refering here only for adding new README files in all examples with explanations nothing else.

@vinodhabib vinodhabib changed the title examples: GRPC Examples documentation and Consistency on directory structure changes examples: Added README files for all Example with Explanation and Consistency on directory structure changes for example-alts Jan 9, 2025
@vinodhabib vinodhabib changed the title examples: Added README files for all Example with Explanation and Consistency on directory structure changes for example-alts examples: Added README files for all missing Examples with Explanation and Consistency on directory structure changes for example-alts Jan 9, 2025
@shivaspeaks shivaspeaks changed the title examples: Added README files for all missing Examples with Explanation and Consistency on directory structure changes for example-alts examples: Added README files for all missing Examples Jan 20, 2025
entirely, set environment variable `DISABLE_RETRYING_IN_RETRYING_EXAMPLE=true` before running the client.
Disabling the retry policy should produce many more failed gRPC calls as seen in the output log.

See [the section](https://github.com/grpc/grpc-java/blob/master/COMPILING.md) for how to build and run the example. The
Copy link
Member

Choose a reason for hiding this comment

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

I don't think this link is pointing to the right target. The content of build the example is what we wanted.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed

@shivaspeaks shivaspeaks added the kokoro:run Add this label to a PR to tell Kokoro the code is safe and tests can be run label Jan 22, 2025
@grpc-kokoro grpc-kokoro removed the kokoro:run Add this label to a PR to tell Kokoro the code is safe and tests can be run label Jan 22, 2025
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.

Enhancements to examples
5 participants