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

[doc] Improve Pulsar deployment AWS #5093

Merged
merged 2 commits into from Sep 4, 2019
Merged

[doc] Improve Pulsar deployment AWS #5093

merged 2 commits into from Sep 4, 2019

Conversation

Monica-zy
Copy link
Contributor

Motivation
Improve the language and the overall descriptive style of the Pulsar Deployment document (deploy-aws section): http://pulsar.apache.org/docs/en/next/deploy-aws/

Modifications
Adjust the tone, personal pronouns, voice also some typo errors of some sentences in the document.

@Monica-zy
Copy link
Contributor Author

@Anonymitaet please review~ thank you^^

@@ -30,9 +30,9 @@ You can install Ansible on Linux or macOS using pip.
$ pip install ansible
```

You can install Terraform using the instructions [here](https://www.terraform.io/intro/getting-started/install.html).
You can install Terraform following the instructions from [here](https://www.terraform.io/intro/getting-started/install.html).
Copy link
Member

Choose a reason for hiding this comment

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

Original is correct, why modify this sentence?

@@ -41,11 +41,11 @@ $ cd pulsar/deployment/terraform-ansible/aws

## SSH setup

> If you already have an SSH key and would like to use it, you skip generating the SSH keys and update `private_key_file` setting
> If you already have an SSH key and want to use it, you can skip the generating the SSH keys step and update `private_key_file` setting
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
> If you already have an SSH key and want to use it, you can skip the generating the SSH keys step and update `private_key_file` setting
> If you already have an SSH key and want to use it, you can skip the step of generating an SSH key and update `private_key_file` setting.

> For example, if you already had a private SSH key in `~/.ssh/pulsar_aws` and a public key in `~/.ssh/pulsar_aws.pub`,
> you can do followings:
> For example, if you already have a private SSH key in `~/.ssh/pulsar_aws` and a public key in `~/.ssh/pulsar_aws.pub`,
> you can do the following:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
> you can do the following:
> follow the steps below.


For a quick demonstration of accessing the cluster, we can use the Python client for Pulsar and the Python shell. First, install the Pulsar Python module using pip:

```bash
$ pip install pulsar-client
```

Now, open up the Python shell using the `python` command:
Now, open up the Python shell entering the `python` command:
Copy link
Member

Choose a reason for hiding this comment

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

Original is correct

@sijie sijie added doc Your PR contains doc changes, no matter whether the changes are in markdown or code files. component/website labels Sep 4, 2019
@sijie sijie added this to the 2.5.0 milestone Sep 4, 2019
@sijie sijie merged commit 16c15ed into apache:master Sep 4, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Your PR contains doc changes, no matter whether the changes are in markdown or code files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants