update readmes

plugins/websocket/README.md

@@ -4,14 +4,56 @@
 
 ## Install
 
+There are three general methods of installation that we can recommend.
+
+1. Use crates.io and npm (easiest, and requires you to trust that our publishing pipeline worked)
+2. Pull sources directly from Github using git tags / revision hashes (most secure)
+3. Git submodule install this repo in your tauri project and then use file protocol to ingest the source (most secure, but inconvenient to use)
+
+Install the Core plugin by adding the following to your `Cargo.toml` file:
+
+`src-tauri/Cargo.toml`
+```toml
+[dependencies]
+tauri-plugin-websocket = { git = "https://github.com/tauri-apps/plugins-workspace", branch = "dev" }
 ```
 
+You can install the JavaScript Guest bindings using your preferred JavaScript package manager:
+
+> Note: Since most JavaScript package managers are unable to install packages from git monorepos we provide read-only mirrors of each plugin. This makes installation option 2 more ergonomic to use.
+
+```sh
+pnpm add https://github.com/tauri-apps/tauri-plugin-websocket
+# or
+npm add https://github.com/tauri-apps/tauri-plugin-websocket
+# or 
+yarn add https://github.com/tauri-apps/tauri-plugin-websocket
 ```
 
 ## Usage
 
+First you need to register the core plugin with Tauri:
+
+`src-tauri/src/main.rs`
+```rust
+fn main() {
+    tauri::Builder::default()
+        .plugin(tauri_plugin_websocket::init())
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}
 ```
 
+Afterwards all the plugin's APIs are available through the JavaScript guest bindings:
+
+```javascript
+import { WebSocket } from 'tauri-plugin-websocket-api'
+
+const ws = await WebSocket.connect('wss://example.com')
+
+await ws.send('Hello World')
+
+await ws.disconnect()
 ```
 
 ## Contributing
@@ -20,6 +62,6 @@ PRs accepted. Please make sure to read the Contributing Guide before making a pu
 
 ## License
 
-Code: (c) 2015 - 2021 - The Tauri Programme within The Commons Conservancy.
+Code: (c) 2015 - Present - The Tauri Programme within The Commons Conservancy.
 
 MIT or MIT/Apache 2.0 where applicable.