fix: cleanup docs about deps and icon commands (tauri-apps#484)

* fix: cleanup docs for `deps` and `icon` commands

* fix: use bash for codeblock syntax highlighting

* Update docs/guides/icons.md

Co-authored-by: Amr Bashir <[email protected]>

* remove section about deps command

Co-authored-by: Amr Bashir <[email protected]>

Author: FabianLars

docs/.templates/cli.md

@@ -6,8 +6,6 @@ title: CLI
 import Command from '@theme/Command'
 import Alert from '@theme/Alert'
 
-The `cli.js` command line interface is composed in TypeScript and published as a JavaScript NPM. It offers the `deps` and the `icon` commands, and propagates other commands to `cli.rs`.
-
 ## `info`
 
 <Command name="info" />
@@ -43,12 +41,6 @@ If you have entered a command to the `build.beforeDevCommand` property, this one
 If you're not using `build.beforeDevCommand`, make sure your `build.devPath` is correct and, if using a development server, that it's started before using this command.
 </Alert>
 
-## `deps`
-
-<Command name="deps" />
-
-{deps}
-
 ## `build`
 
 <Command name="build" />
@@ -61,27 +53,6 @@ If you have entered a command to the `build.beforeBuildCommand` property, this o
 
 <a href="/docs/api/config#build">See more about the configuration.</a>
 
-## `icon`
-
-<Command name="icon" />
-
-```
-  Description
-    Create all the icons you need for your Tauri app.
-
-  Usage
-    $ tauri icon /path/to/icon.png
-
-  Options
-    --help, -h           Displays this message
-    --log, -l            Logging [boolean]
-    --target, -t         Target folder (default: 'src-tauri/icons')
-    --compression, -c    Compression type [optipng|zopfli]
-    --ci                 Runs the script in CI mode     
-```
-
-This command will generate a set of icons, based on the source icon you've entered. Note that the source icon must be 1240x1240 with transparency.
-
 ## `version`
 
 <Command name="--version" />

docs/api/cli.md

@@ -6,8 +6,6 @@ title: CLI
 import Command from '@theme/Command'
 import Alert from '@theme/Alert'
 
-The `cli.js` command line interface is composed in TypeScript and published as a JavaScript NPM. It offers the `deps` and the `icon` commands, and propagates other commands to `cli.rs`.
-
 ## `info`
 
 <Command name="info" />
@@ -106,12 +104,6 @@ If you have entered a command to the `build.beforeDevCommand` property, this one
 If you're not using `build.beforeDevCommand`, make sure your `build.devPath` is correct and, if using a development server, that it's started before using this command.
 </Alert>
 
-## `deps`
-
-<Command name="deps" />
-
-{deps}
-
 ## `build`
 
 <Command name="build" />
@@ -146,27 +138,6 @@ If you have entered a command to the `build.beforeBuildCommand` property, this o
 
 <a href="/docs/api/config#build">See more about the configuration.</a>
 
-## `icon`
-
-<Command name="icon" />
-
-```
-  Description
-    Create all the icons you need for your Tauri app.
-
-  Usage
-    $ tauri icon /path/to/icon.png
-
-  Options
-    --help, -h           Displays this message
-    --log, -l            Logging [boolean]
-    --target, -t         Target folder (default: 'src-tauri/icons')
-    --compression, -c    Compression type [optipng|zopfli]
-    --ci                 Runs the script in CI mode     
-```
-
-This command will generate a set of icons, based on the source icon you've entered. Note that the source icon must be 1240x1240 with transparency.
-
 ## `version`
 
 <Command name="--version" />

docs/building/app-size.md

@@ -247,20 +247,20 @@ The following suggestions are all unstable features and require a nightly toolch
 
 The following methods involve using unstable compiler features and require the rust nightly toolchain. If you don't have the nightly toolchain + `rust-src` nightly component added, try the following:
 
-```sh
+```bash
 rustup toolchain install nightly
 rustup component add rust-src --toolchain nightly
 ```
 
 The Rust Standard Library comes precompiled. This means rust is faster to install, but also that the compiler can't optimize the Standard Library. You can apply the optimization options for the rest of your binary + dependencies to the std with an unstable flag. This flag requires specifying your target, so know the target triple you are targeting.
 
-```sh
+```bash
 cargo +nightly build --release -Z build-std --target x86_64-unknown-linux-gnu
 ```
 
 If you are using `panic = "abort"` in your release profile optimizations, you need to make sure the `panic_abort` crate is compiled with std. Additionally, an extra std feature can further reduce the binary size. The following applies both:
 
-```sh
+```bash
 cargo +nightly build --release -Z build-std=std,panic_abort -Z build-std-features=panic_immediate_abort --target x86_64-unknown-linux-gnu
 ```
 
@@ -278,7 +278,7 @@ Your compiled app includes so-called "Debug Symbols" that include function and v
 
 The easiest way is to use the famous `strip` utility to remove this debugging information.
 
-```sh
+```bash
 strip target/release/my_application
 ```
 
@@ -304,7 +304,7 @@ You should know that this technique might flag your binary as a virus on Windows
 
 #### Usage on macOS
 
-```sh
+```bash
 brew install upx
 yarn tauri build
 upx --ultra-brute src-tauri/target/release/bundle/macos/app.app/Contents/macOS/app

docs/community/contributor-guide.md

@@ -32,7 +32,7 @@ When contributing to the Rust libraries `tauri`, `tauri-api`, and `tauri-updater
 
 Let's make a new example. That's a great way to learn. We assume you are on a nixy type of environment like Linux or macOS and have all of your development dependencies like rust and node already sorted out.
 
-```sh
+```bash
 git clone [email protected]:tauri-apps/tauri.git
 cd tauri/cli/tauri.js
 yarn

docs/debugging/debugging.md

@@ -14,13 +14,13 @@ println!("Message from Rust: {}", msg);
 
 Sometimes you may have an error in your Rust code, and the Rust compiler can give you lots of information. If, for example, `tauri dev` crashes, you can rerun it like this on Linux and macOS:
 
-```sh
+```bash
 RUST_DEBUG=1 tauri dev
 ```
 
 or like this on MS Windows:
 
-```sh
+```bash
 set RUST_DEBUG=1
 tauri dev
 ```

docs/development/updating-dependencies.md

@@ -4,13 +4,7 @@
 Especially during the alpha and beta phases, we expect you to keep all Tauri dependencies and toolchains up to date. There is no support for any versions other than latest.
 :::
 
-## Automatic updates
-
-The Tauri JS CLI has a command to install and update all needed dependencies, just run `tauri deps install` or `tauri deps update`.
-
-## Manual updates
-
-### Update NPM Packages
+## Update NPM Packages
 
 If you are using the `tauri` package:
 
@@ -31,16 +25,32 @@ yarn upgrade vue-cli-plugin-tauri --latest
 npm install vue-cli-plugin-tauri@latest
 ```
 
-### Update Cargo Packages
+## Update Cargo Packages
+
+You can check for outdated packages with [`cargo outdated`] or on the crates.io pages: [tauri] / [tauri-build].
+
+Go to `src-tauri/Cargo.toml` and change `tauri` and `tauri-build` to
 
-Go to `src-tauri/Cargo.toml` and change `tauri` to
-`tauri = { version = "%version%" }` where `%version%` is the version number shown above. (You can just use the `MAJOR.MINOR`) version, like `0.9`.
+```toml
+[build-dependencies]
+tauri-build = "%version%"
+
+[dependencies]
+tauri = { version = "%version%" }
+```
+
+where `%version%` is the corresponding version number from above. <!-- TODO: (You can just use the `MAJOR.MINOR`) version, like `0.9`. -->
 
 Then do the following:
 
 ```bash
 cd src-tauri
-cargo update -p tauri
+cargo update
 ```
 
-You can also run `cargo outdated -r tauri` to get direct information about the core library's latest version.
+Alternatively you can run the `cargo upgrade` command provided by [cargo-edit] which does all of this automatically.
+
+[`cargo outdated`]: https://github.com/kbknapp/cargo-outdated
+[tauri]: https://crates.io/crates/tauri/versions
+[tauri-build]: https://crates.io/crates/tauri-build/versions
+[cargo-edit]: https://github.com/killercup/cargo-edit

docs/getting-started/beginning-tutorial.md

@@ -4,10 +4,11 @@ import Link from '@docusaurus/Link'
 # Your First Tauri App
 
 :::caution
-You must have completed all the steps required for setting up the development environment on your machine. Please see the [setup page for your operating system][Prerequisites] if you haven't done this yet.
+You must have completed all the steps required for setting up the development environment on your machine. Please see the [setup page for your operating system][prerequisites] if you haven't done this yet.
 :::
 
 There are two ways to integrate with Tauri depending on your needs:
+
 - [Start a new Tauri project](#1-start-a-new-tauri-project)
 - Or [add Tauri to existing project](#1-add-tauri-to-existing-project)
 
@@ -83,7 +84,7 @@ npm install @tauri-apps/api
 
 This command places a new folder in your current working directory, `src-tauri`.
 
-```sh
+```bash
 └── src-tauri
     ├── .gitignore
     ├── Cargo.toml
@@ -158,13 +159,13 @@ This information can be beneficial when triaging problems.
 ### Recipes
 
 We've also defined prebuilt configurations called "Recipes". They may help you to customize Tauri to fit your needs.
-[See more about recipes][Recipes].
+[See more about recipes][recipes].
 
 ## Vue CLI Plugin Tauri
 
 If you are using Vue CLI, it is recommended to use the official [Vue CLI plugin].
 
-[Prerequisites]: ./prerequisites.md
+[prerequisites]: ./prerequisites.md
 [`cargo install`]: https://doc.rust-lang.org/cargo/commands/cargo-install.html#description
-[Recipes]: ../architecture/recipes/about-recipes.md
-[Vue CLI plugin]: https://github.com/tauri-apps/vue-cli-plugin-tauri
+[recipes]: ../architecture/recipes/about-recipes.md
+[vue cli plugin]: https://github.com/tauri-apps/vue-cli-plugin-tauri

docs/getting-started/setting-up-linux.md

@@ -22,7 +22,7 @@ values={[
 ]}>
 <TabItem value="debian">
 
-```sh
+```bash
 sudo apt update && sudo apt install libwebkit2gtk-4.0-dev \
     build-essential \
     curl \
@@ -36,7 +36,7 @@ sudo apt update && sudo apt install libwebkit2gtk-4.0-dev \
 </TabItem>
 <TabItem value="arch">
 
-```sh
+```bash
 sudo pacman -Syu && sudo pacman -S --needed \
     webkit2gtk \
     base-devel \
@@ -53,7 +53,7 @@ sudo pacman -Syu && sudo pacman -S --needed \
 </TabItem>
 <TabItem value="fedora">
 
-```sh
+```bash
 sudo dnf check-update && sudo dnf install webkit2gtk3-devel.x86_64 \
     openssl-devel \
     curl \
@@ -77,7 +77,7 @@ sudo dnf check-update && sudo dnf install webkit2gtk3-devel.x86_64 \
 
 We recommend using nvm to manage your Node.js runtime. It allows you to switch versions and update Node.js easily.
 
-```sh
+```bash
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash
 ```
 
@@ -87,7 +87,7 @@ We have audited this bash script, and it does what it says it is supposed to do.
 
 Once nvm is installed, close and reopen your terminal, then install the latest version of Node.js and npm:
 
-```sh
+```bash
 nvm install node --latest-npm
 nvm use node
 ```
@@ -115,7 +115,7 @@ We have audited this bash script, and it does what it says it is supposed to do.
 
 To make sure that Rust has been installed successfully, run the following command:
 
-```sh
+```bash
 rustc --version
 
 latest update on 2019-12-19, rust version 1.40.0

docs/getting-started/setting-up-macos.md

@@ -13,7 +13,7 @@ import Icon from '@theme/Icon'
 
 Make sure you have `xcode` installed.
 
-```sh
+```bash
 xcode-select --install
 ```
 
@@ -23,7 +23,7 @@ xcode-select --install
 
 We recommend using nvm to manage your Node.js runtime. It allows you to switch versions and update Node.js easily.
 
-```sh
+```bash
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash
 ```
 
@@ -33,7 +33,7 @@ We have audited this bash script, and it does what it says it is supposed to do.
 
 Once nvm is installed, close and reopen your terminal, then install the latest version of Node.js and npm:
 
-```sh
+```bash
 nvm install node --latest-npm
 nvm use node
 ```
@@ -61,7 +61,7 @@ We have audited this bash script, and it does what it says it is supposed to do.
 
 To make sure that Rust has been installed successfully, run the following command:
 
-```sh
+```bash
 rustc --version
 
 latest update on 2019-12-19, rust version 1.40.0