-
Notifications
You must be signed in to change notification settings - Fork 1.2k
edited general repo readme #351
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
Conversation
645e10e
to
d276604
Compare
README.rst
Outdated
@@ -36,16 +39,16 @@ Table of Contents | |||
11. `BYO Model <#byo-model>`__ | |||
|
|||
|
|||
Getting SageMaker Python SDK | |||
Installing SageMaker Python SDK |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should it be "the SageMaker Python SDK"? (I'm sure we're inconsistent throughout our docs about it...)
README.rst
Outdated
|
||
:: | ||
|
||
pip install sagemaker | ||
|
||
You can install from source by cloning this repository and issuing a pip install command in the root directory of the repository. | ||
You can install from the source by cloning this repository and running a pip install command in the root directory of the repository: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think "from source" is an idiom here
README.rst
Outdated
|
||
SageMaker Python SDK includes Estimator wrappers for the AWS K-means, Principal Components Analysis(PCA), Linear Learner, Factorization Machines, Latent Dirichlet Allocation(LDA), Neural Topic Model(NTM) Random Cut Forest and k-nearest neighbors (k-NN) algorithms. | ||
SageMaker Python SDK includes estimator wrappers for the AWS K-means, Principal Components Analysis(PCA), Linear Learner, Factorization Machines, | ||
Latent Dirichlet Allocation(LDA), Neural Topic Model(NTM) Random Cut Forest and k-nearest neighbors (k-NN) algorithms. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should there be spaces before "(PCA)", "(LDA)", and "(NTM)"?
README.rst
Outdated
|
||
.. _AWS SageMaker Estimators and Models: src/sagemaker/amazon/README.rst | ||
|
||
|
||
BYO Docker Containers with SageMaker Estimators | ||
----------------------------------------------- | ||
|
||
When you want to use a Docker image prepared earlier and use SageMaker SDK for training the easiest way is to use dedicated ``Estimator`` class. You will be able to instantiate it with desired image and use it in same way as described in previous sections. | ||
To use a Docker image that you created and use the SageMaker SDK for training, the easiest way is to use the dedicated ``Estimator`` class. | ||
You can create an instance of the ``Estimator`` class with desired docker image and use it as described in previous sections. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
capitalize "Docker"
README.rst
Outdated
This example shows a hyperparameter tuning job that creates up to 100 training jobs, running up to 10 at a time. | ||
Each training job's learning rate will be a value between 0.05 and 0.06, but this value will differ between training jobs. | ||
This example shows a hyperparameter tuning job that creates up to 100 training jobs, running up to 10 training jobs at a time. | ||
Each training job's learning rate will is a value between 0.05 and 0.06, but this value will differ between training jobs. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
remove "will" from "will is"
README.rst
Outdated
@@ -511,4 +521,4 @@ After that, invoke the ``deploy()`` method on the ``Model``: | |||
|
|||
This returns a predictor the same way an ``Estimator`` does when ``deploy()`` is called. You can now get inferences just like with any other model deployed on Amazon SageMaker. | |||
|
|||
A full example is available in the `Amazon SageMaker examples repository <https://github.com/ragavvenkatesan/amazon-sagemaker-examples/tree/3c8394f21ee357da0b553b0ab024c5c5e425182a/advanced_functionality/mxnet_mnist_byom>`__. | |||
A full example is available in the `Amazon SageMaker examples repository <https://github.com/ragavvenkatesan/amazon-sagemaker-examples/tree/3c8394f21ee357da0b553b0ab024c5c5e425182a/advanced_functionality/mxnet_mnist_byom>`__. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this link is to a fork of the examples repo - probably should link it to the real one?
Codecov Report
@@ Coverage Diff @@
## master #351 +/- ##
=======================================
Coverage 92.93% 92.93%
=======================================
Files 51 51
Lines 3552 3552
=======================================
Hits 3301 3301
Misses 251 251 Continue to review full report at Codecov.
|
Added short note about validation channel
Issue #, if available:
Description of changes:
Edited the readme for clarity/style.
Please review, esp hyperparameter tuning and batch transform sections for technical accuracy.
Merge Checklist
Put an
x
in the boxes that apply. You can also fill these out after creating the PR. If you're unsure about any of them, don't hesitate to ask. We're here to help! This is simply a reminder of what we are going to look for before merging your pull request.By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.