Small readme rewrites for clarification (#154)

Author: npentrel

README.md

@@ -4,62 +4,89 @@
 [![license](https://img.shields.io/badge/license-Apache_2.0-blue)](https://github.com/viamrobotics/viam-python-sdk/blob/main/LICENSE)
 
 ## (In)stability Notice
-This is an alpha release of the Viam Python SDK. Stability is not guaranteed. Breaking changes are likely to occur, and occur often.
+
+> **Warning**
+> This is an alpha release of the Viam Python SDK. Stability is not guaranteed. Breaking changes are likely to occur, and occur often.
 
 ## Installation - pre PyPI
 
-`pip install git+https://github.com/viamrobotics/python-sdk.git`
+To install the Viam Python SDK from the current `main` branch, use the following command:
 
-This will install the current `main` branch to your project. If you would like a specific branch or commit, you can do so with the command
+```
+pip install git+https://github.com/viamrobotics/python-sdk.git
+```
 
-`pip install git+https://github.com/viamrobotics/python-sdk.git@FULL_COMMIT_HASH`
+To install the the Viam Python SDK from a specific branch or commit, use the following command:
+
+```
+pip install git+https://github.com/viamrobotics/python-sdk.git@FULL_COMMIT_HASH
+```
 
 ### Upgrading
-Because the SDK is under active development, we suggest that you upgrade the package frequently. To do so, simply run the `pip install` command with the `-U` option:
 
-`pip install -U git+https://github.com/viamrobotics/python-sdk.git`
+> **Note**
+> Because the SDK is under active development, we suggest that you upgrade the package frequently. 
+ 
+To upgrade, simply run the `pip install` command with the `-U` option:
+
+```
+pip install -U git+https://github.com/viamrobotics/python-sdk.git
+```
+
+## Configure a client application at [app.viam.com](https://app.viam.com)
+
+Your client application does not directly interact with your hardware. Instead, your client application makes calls to the viam-server which can then issues commands to your hardware or read from sensors.
 
-## Easy Setup via [app.viam.com](app.viam.com)
-The easiest way to get started writing a client application (that is, one which is not directly responsible for interacting with hardware,
-but rather calls into the viam-server to actuate hardware or read from sensors), is to navigate to the robot page on [app.viam.com](app.viam.com),
-select the `CONNECT` tab, and copy the boilerplate code from the section labeled `Python SDK`.
+To create a client application, to navigate to [app.viam.com](https://app.viam.com). After you log in, perform these steps:
 
-It is recommended that you save and run this simple program. Doing so will ensure that the python-sdk is properly installed,
-that the `viam-server` instance on your robot is alive, and that the computer running the program is able to connect to that instance.
+1. Create a location (for example `home`)
+2. Create a robot (for example `arduino`)
+3. Follow the steps on the setup tab:
+   1. Setup Viam App Config on Single Board Computer (SBC)
+   2. Download and Install Viam Server
+   3. Wait until the robot shows as connected. If this doesn't happen try restarting the viam-server:
+      ```
+      sudo systemctl restart viam-server
+      ```   
+
+Next, select the `CONNECT` tab in the Viam Web UI, and copy the boilerplate code from the section labeled `Python SDK`.
+
+To ensure the installation succeeded and the systems are functional, save and run this simple program. If the program runs successfully, the python-sdk is properly installed, the `viam-server` instance on your robot is alive, and the computer running the program is able to connect to that instance.
 
 ## Examples
-The [Example Usage](https://python.viam.dev/examples/example.html) has the info required to access a component, build a custom component, and expose
+Read the [Example Usage](https://python.viam.dev/examples/example.html) page, to learn how to access a component, build a custom component, and expose
 custom components as a remote to existing robots.
 
-Further examples can be found in the `examples` directory.
+More examples can be found in the [`examples`](/examples) directory.
 
 ## The `do` method
 Every component provided by the SDK includes a generic `do` method which is useful to execute commands that are not already defined on the component.
 ```python
 async def do(self, command: Dict[str, Any]) -> Dict[str, Any]
 ```
 
-If this is not generic enough, you can also create your own custom component by subclassing the `viam.components.generic.Generic` component
-class. For more details, you can view the documentation for the `Generic` component.
+If this is not generic enough, you can also create your own custom component by subclassing the [`viam.components.generic.Generic`](https://python.viam.dev/autoapi/viam/components/generic/index.html) component
+class. For more details, you can view the documentation for the [`Generic`](https://python.viam.dev/autoapi/viam/components/generic/index.html) component.
 
 ## Documentation
 Documentation, like this entire project, is under active development, and can be found at [python.viam.dev](https://python.viam.dev).
 
 ---
 ## Development
-To develop the python SDK, please see the [contribution guidelines](https://python.viam.dev/contributing.html).
+To contribute to the python SDK, please see the [contribution guidelines](https://python.viam.dev/contributing.html).
+
 ### Adding new component types
-The SDK provides a number of abstract base components to start. To add more abstract base components, please make sure you follow these guidelines:
-
-* Create a new directory in `viam.components` with the name of the new component
-* Implement 3 new files in the newly created directory:
-    * `__init__.py`, where you should include the imports for the package
-    * `{COMPONENT}.py`, which should define the requirements of the component
-    * `service.py`, which should implement the gRPC service for this component
-* Add the new service in `viam.rpc.server` to expose the gRPC service
-* If the component needs to be included to the robot/status service, add it in `viam.robot.service`
-* Write tests and add the component to `tests.mocks.components`
-* Add the component to `examples.server.v1.components` and its corresponding concrete type in `examples.server.v1.server`
+The SDK provides a number of abstract base components. To add more abstract base components, follow these steps:
+
+1. Create a new directory in `viam.components` with the name of the new component
+2. Create 3 new files in the newly created directory:
+    1. Add all imports for the package in `__init__.py`
+    2. Define all requirements of the component in `{COMPONENT}.py`
+    3. Implement the gRPC service for the new component in `service.py`
+3. Add the new service to [`viam.rpc.server`](https://python.viam.dev/autoapi/viam/rpc/server/index.html) to expose the gRPC service
+4. If the component needs to be included in the robot/status service, add it in [`viam.robot.service`](https://python.viam.dev/autoapi/viam/robot/service/index.html)
+5. Write tests for the new component and add the component to `tests.mocks.components`
+6. Add the component to `examples.server.v1.components` and its corresponding concrete type in `examples.server.v1.server`
 
 ## License
 Copyright 2021-2022 Viam Inc.