Skip to content

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

Merged
merged 3 commits into from
Aug 15, 2018
Merged

edited general repo readme #351

merged 3 commits into from
Aug 15, 2018

Conversation

eslesar-aws
Copy link
Contributor

@eslesar-aws eslesar-aws commented Aug 14, 2018

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.

  • I have read the CONTRIBUTING doc
  • I have added tests that prove my fix is effective or that my feature works (if appropriate)
  • I have updated the changelog with a description of my changes (if appropriate)
  • I have updated any necessary documentation (if appropriate)

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

README.rst Outdated
@@ -36,16 +39,16 @@ Table of Contents
11. `BYO Model <#byo-model>`__


Getting SageMaker Python SDK
Installing SageMaker Python SDK
Copy link
Contributor

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:
Copy link
Contributor

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.
Copy link
Contributor

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.
Copy link
Contributor

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.
Copy link
Contributor

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>`__.
Copy link
Contributor

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-io
Copy link

codecov-io commented Aug 14, 2018

Codecov Report

Merging #351 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           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.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 6ac8f08...760ba54. Read the comment docs.

@laurenyu laurenyu merged commit 146e171 into aws:master Aug 15, 2018
pdasamzn pushed a commit to pdasamzn/sagemaker-python-sdk that referenced this pull request Nov 1, 2018
apacker pushed a commit to apacker/sagemaker-python-sdk that referenced this pull request Nov 15, 2018
Added short note about validation channel
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.

4 participants