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

Document what constitutes public API #2175

Merged
merged 1 commit into from
Jan 23, 2025
Merged

Conversation

glbrntt
Copy link
Collaborator

@glbrntt glbrntt commented Jan 23, 2025

Motivation:

SemVer packages should descibe what constitutes their API.

Modifications:

  • Add a doc explaining what the public API is

Result:

More docs

Motivation:

SemVer packages should descibe what constitutes their API.

Modifications:

- Add a doc explaining what the public API is

Result:

More docs
@glbrntt glbrntt added the semver/none No version bump required. label Jan 23, 2025
@glbrntt glbrntt requested a review from gjcairo January 23, 2025 14:43
@glbrntt glbrntt enabled auto-merge (squash) January 23, 2025 14:43
Copy link
Collaborator

@gjcairo gjcairo left a comment

Choose a reason for hiding this comment

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

LGTM, a few minor typos/nits.


### Library targets

All library targets made available as package products as considered to be
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
All library targets made available as package products as considered to be
All library targets made available as package products are considered to be

Comment on lines +10 to +11
part of the public API; commitments the maintainers make relating to the API;
and guidelines for users.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
part of the public API; commitments the maintainers make relating to the API;
and guidelines for users.
part of the public API, commitments the maintainers make relating to the API,
and guidelines for users.

part of the public API; commitments the maintainers make relating to the API;
and guidelines for users.

For clarity the project is comprised of the following Swift packages:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
For clarity the project is comprised of the following Swift packages:
For clarity, the project is comprised of the following Swift packages:

@glbrntt glbrntt merged commit fa33525 into grpc:main Jan 23, 2025
28 of 30 checks passed
@gjcairo
Copy link
Collaborator

gjcairo commented Jan 23, 2025

Ah, didn't notice auto merge had been enabled. It's fine, would be cool if you fixed these things in a follow-up though

glbrntt added a commit to glbrntt/grpc-swift that referenced this pull request Jan 23, 2025
Motivation:

Some comments on grpc#2175 were missed becuase automerge was enabled and the
PR got approved.

Modification:

Fix typos/punctuation.

Result:

Better docs.
@glbrntt glbrntt mentioned this pull request Jan 23, 2025
glbrntt added a commit that referenced this pull request Jan 24, 2025
Motivation:

Some comments on #2175 were missed becuase automerge was enabled and the
PR got approved.

Modification:

Fix typos/punctuation.

Result:

Better docs.
@glbrntt glbrntt deleted the v2/public-api branch January 24, 2025 08:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
semver/none No version bump required.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants