Skip to content

Conversation

@TheIronDev
Copy link
Contributor

Updated PubSub docs, removing unused types + top-level comments

@TheIronDev TheIronDev force-pushed the tystark.pubsub-docs-strike-back-with-a-vengeance branch from 39cc50a to 4bfb2cb Compare May 10, 2022 18:10
Copy link
Member

@joehan joehan left a comment

Choose a reason for hiding this comment

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

Some nits, but I see that this is copied from the linked docs, so feel free to ignore


/**
* A PubSub Topic is:
* Google Cloud's Pub/Sub is a globally distributed message bus that automatically scales as you need it.
Copy link
Member

Choose a reason for hiding this comment

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

I think this should be just Google Cloud Pub/Sub

Copy link
Member

Choose a reason for hiding this comment

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

+1

* Google Cloud's Pub/Sub is a globally distributed message bus that automatically scales as you need it.
* You can create a function ({@link onMessagePublished}) that handles Pub/Sub events by using functions.pubsub.
*
* You can trigger a function whenever a new Pub/Sub message is sent to a specific topic.
Copy link
Member

Choose a reason for hiding this comment

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

Nit: 'This functions triggers whenever a new Pub/Sub...`

Copy link
Member

Choose a reason for hiding this comment

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

@egilmorez may have opinions, but pub/sub should probably be lower case since it's not the product name.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Makes sense, updated!

Copy link
Member

@inlined inlined left a comment

Choose a reason for hiding this comment

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

Great docs!


/**
* A PubSub Topic is:
* Google Cloud's Pub/Sub is a globally distributed message bus that automatically scales as you need it.
Copy link
Member

Choose a reason for hiding this comment

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

+1

* Google Cloud's Pub/Sub is a globally distributed message bus that automatically scales as you need it.
* You can create a function ({@link onMessagePublished}) that handles Pub/Sub events by using functions.pubsub.
*
* You can trigger a function whenever a new Pub/Sub message is sent to a specific topic.
Copy link
Member

Choose a reason for hiding this comment

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

@egilmorez may have opinions, but pub/sub should probably be lower case since it's not the product name.

@TheIronDev TheIronDev force-pushed the tystark.pubsub-docs-strike-back-with-a-vengeance branch from a24de32 to 8ecaa39 Compare May 10, 2022 19:01
@TheIronDev TheIronDev merged commit 2e97603 into master May 10, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

3 participants