Reorganized install related readme, docs and learn

Author: NorOldBurden

README.md

@@ -111,22 +111,11 @@ The following blockchain libraries (generated by Telescope) are available via np
 
 Follow the instructions below to generate a new Typescript package that you can publish to npm. You can also follow the video: https://youtu.be/iQf6p65fbdY
 
-First, install `telescope` 
-```sh
-npm install -g @cosmology/telescope
-```
-
-then install either
-
 `create-interchain-app`
 ```sh
 npm install -g create-interchain-app
 ```
-Or
-`create-cosmos-app`
-```sh
-npm install -g create-cosmos-app
-```
+
 
 ### Generate
 
@@ -135,13 +124,6 @@ Use the [`create-interchain-app`](https://github.com/hyperweb-io/create-intercha
 ```sh
 cia --boilerplate telescope
 
-or 
-
-Use the [`create-cosmos-app`](https://github.com/hyperweb-io/create-cosmos-app/) command to create a new package from the `telescope` boilerplate.
-
-```sh
-cca --boilerplate telescope
-```
 
 Then, you'll navigate into `./your-project/packages/telescope` package for the next steps.
 
@@ -181,11 +163,117 @@ yarn build
 
 ### Publishing
 
-Now you should have code inside of your `./src` folder, ready for publshing. If you used the `create-cosmos-app` boilerplate, use `lerna` to publish (and/or read the README in the boilerplate for instructions), or run `npm publish` from your repository.
+Now you should have code inside of your `./src` folder, ready for publshing. If you used the `create-interchain-app` boilerplate, use `lerna` to publish (and/or read the README in the boilerplate for instructions), or run `npm publish` from your repository.
 
 # Usage
 
-## Programatic Usage
+## Advanced Install
+The methods below are all the options you can use to install and use Telescope
+
+### Telescope CLI
+Install telescope
+```sh
+npm install -g @cosmology/telescope
+```
+The steps by order are: generate, download and transpile.
+
+1.Generate a package with the telescope CLI:
+
+Use and follow the default prompt:
+```sh
+telescope generate
+```
+
+Or advanced cli option by your choice:
+```sh
+telescope generate --access public --userfullname "Your Name" --useremail "your@email.com" --module-desc "Your module description" --username "your-username" --license MIT --module-name "your-module" --chain-name cosmos --use-npm-scoped
+```
+
+Available options:
+- `--userfullname`: Your full name
+- `--useremail`: Your email
+- `--module-desc`: Module description
+- `--username`: GitHub username
+- `--module-name`: Module name
+- `--chain-name`: Chain name
+- `--access`: Package access (`public` or `private`)
+- `--use-npm-scoped`: Use npm scoped package (only works with `--access public`)
+- `--license`: License type
+
+2.Download protocol buffer files:
+```sh
+telescope download
+```
+
+This will clone repositories into `./git-modules` and generate proto files in `./protos`.
+
+Download with a config file:
+```sh
+telescope download --config ./protod.config.json --out ./git-modules
+```
+
+Download from a specific repo:
+```sh
+telescope download --git-repo owner/repository --targets cosmos/auth/v1beta1/auth.proto
+```
+
+3. Transpile (Generate TypeScript code from proto files):
+Use default telescope option:
+```sh
+telescope transpile
+```
+
+Use customized telescope option:
+```sh
+telescope transpile --config your-config.json
+```
+
+### CIA
+Please follow the video: https://youtu.be/iQf6p65fbdY
+Or [Go to Quickstart](#quickstart)
+
+### CCA
+First, install `create-cosmos-app`
+
+```sh
+npm install -g create-cosmos-app
+```
+
+Use the [`create-cosmos-app`](https://github.com/hyperweb-io/create-cosmos-app/) command to create a new package from the `telescope` boilerplate.
+
+```sh
+cca --boilerplate telescope
+```
+
+Then, you'll navigate into `./your-project/packages/telescope` package for the next steps.
+
+Install dependency and use cli to download the protos you want.
+```sh
+yarn install
+telescope download --config ./your.config.json
+```
+
+To create the Typescript files for your chain, run the `yarn codegen` command inside of the package.
+
+```sh
+yarn codegen
+```
+
+### Manual install
+If you want to use telescope in your own project.
+
+Run the command in ./your-project
+```sh
+yarn add --dev @cosmology/telescope
+```
+Install helpers and cosmjs [dependencies listed here](#dependencies)
+
+We recommand to use [Go to Programatic Usage](#programatic-usage)
+
+You can also use [Go to Telescope Cli](#telescope-cli)
+To be noted for cli command, add 'npx' or 'yarn' prefix when you use it within your project. For instance: 'yarn telescope generate', 'npx telescope download', etc.
+
+### Programatic Usage
 
 First add telescope to your `devDependencies`:
 
@@ -195,6 +283,39 @@ yarn add --dev @cosmology/telescope
 
 Install helpers and cosmjs [dependencies listed here](#dependencies)
 
+Download command example:
+```js
+import downloadProtos from '@cosmology/telescope/main/commands/download'
+
+const config = {
+  repos: [
+    { owner: "cosmos", repo: "cosmos-sdk", branch: "release/v0.50.x" },
+    { owner: "cosmos", repo: "ibc-go" },
+  ],
+  protoDirMapping: {
+    "gogo/protobuf/master": ".",
+    "googleapis/googleapis/master": ".",
+    "protocolbuffers/protobuf/main": "src"
+  },
+  outDir: "protos",
+  ssh: false,
+  tempRepoDir: "git-modules",
+  targets: [
+    "cosmos/**/*.proto",
+    "ibc/**/*.proto",
+  ]
+};
+
+downloadProtos(config)
+  .then(() => console.log('✅ Proto download completed'))
+  // @ts-ignore
+  .catch((error) => {
+    console.error('❌ Proto download failed:', error);
+    process.exit(1);
+  });
+```
+
+Transpile command example:
 ```js
 import { join } from 'path';
 import telescope from '@cosmology/telescope';
@@ -1269,7 +1390,7 @@ A unified toolkit for building applications and smart contracts in the Interchai
 | **Wallet Connectors**| [**Interchain Kit**](https://github.com/hyperweb-io/interchain-kit)<sup>beta</sup>, [**Cosmos Kit**](https://github.com/hyperweb-io/cosmos-kit) | Experience the convenience of connecting with a variety of web3 wallets through a single, streamlined interface. |
 | **Signing Clients**          | [**InterchainJS**](https://github.com/hyperweb-io/interchainjs)<sup>beta</sup>, [**CosmJS**](https://github.com/cosmos/cosmjs) | A single, universal signing interface for any network |
 | **SDK Clients**              | [**Telescope**](https://github.com/hyperweb-io/telescope)                                                          | Your Frontend Companion for Building with TypeScript with Cosmos SDK Modules. |
-| **Starter Kits**     | [**Create Interchain App**](https://github.com/hyperweb-io/create-interchain-app)<sup>beta</sup>, [**Create Cosmos App**](https://github.com/hyperweb-io/create-cosmos-app) | Set up a modern Interchain app by running one command. |
+| **Starter Kits**     | [**Create Interchain App**](https://github.com/hyperweb-io/create-interchain-app)<sup>beta</sup> | Set up a modern Interchain app by running one command. |
 | **UI Kits**          | [**Interchain UI**](https://github.com/hyperweb-io/interchain-ui)                                                   | The Interchain Design System, empowering developers with a flexible, easy-to-use UI kit. |
 | **Testing Frameworks**          | [**Starship**](https://github.com/hyperweb-io/starship)                                                             | Unified Testing and Development for the Interchain. |
 | **TypeScript Smart Contracts** | [**Create Hyperweb App**](https://github.com/hyperweb-io/create-hyperweb-app)                              | Build and deploy full-stack blockchain applications with TypeScript |