From bd677b8b48260e301fb99fea794f4dc1458d1562 Mon Sep 17 00:00:00 2001
From: marchersimon <50295997+marchersimon@users.noreply.github.com>
Date: Mon, 13 Sep 2021 10:21:21 +0200
Subject: [PATCH] mention subcommands in every base page (#6383)
---
CONTRIBUTING.md | 3 ++-
pages.de/common/ansible.md | 4 ++--
pages.de/common/aws.md | 2 +-
pages.de/common/cargo.md | 2 +-
pages.de/common/cradle.md | 2 +-
pages.de/common/docker.md | 1 +
pages.de/common/dotnet.md | 1 +
pages.de/common/git.md | 1 +
pages.de/windows/choco.md | 2 +-
pages.es/common/adb.md | 1 +
pages.es/common/docker.md | 1 +
pages.es/common/dotnet.md | 1 +
pages.id/common/adb.md | 1 +
pages.id/common/docker.md | 1 +
pages.id/common/git.md | 1 +
pages.id/common/pip.md | 1 +
pages.id/common/vue.md | 1 +
pages.zh/common/adb.md | 1 +
pages.zh/common/ansible.md | 4 ++--
pages.zh/common/docker.md | 1 +
pages.zh/common/vue.md | 3 +--
pages.zh/linux/btrfs.md | 1 +
pages.zh/windows/choco.md | 2 +-
pages.zh/windows/reg.md | 2 +-
pages.zh_TW/common/docker.md | 1 +
pages/common/adb.md | 1 +
pages/common/amass.md | 1 +
pages/common/ansible.md | 4 ++--
pages/common/aws.md | 2 +-
pages/common/az.md | 1 +
pages/common/bundletool.md | 1 +
pages/common/cargo.md | 2 +-
pages/common/conan.md | 1 +
pages/common/conda.md | 1 +
pages/common/consul.md | 1 +
pages/common/cradle.md | 2 +-
pages/common/docker.md | 1 +
pages/common/dolt.md | 1 +
pages/common/dotnet.md | 1 +
pages/common/drupal.md | 4 ++--
pages/common/dvc.md | 1 +
pages/common/fc.md | 1 +
pages/common/gh.md | 1 +
pages/common/git.md | 1 +
pages/common/gitlab.md | 1 +
pages/common/go.md | 1 +
pages/common/hg.md | 2 +-
pages/common/kubectl.md | 2 +-
pages/common/odps.md | 1 +
pages/common/openssl.md | 1 +
pages/common/pio.md | 1 +
pages/common/pip.md | 1 +
pages/common/pueue.md | 1 +
pages/common/rails.md | 1 +
pages/common/virsh.md | 4 ++--
pages/common/vue.md | 1 +
pages/linux/btrfs.md | 1 +
pages/linux/dpkg.md | 1 +
pages/linux/ip.md | 1 +
pages/linux/nmcli.md | 1 +
pages/linux/pacman.md | 1 +
pages/windows/choco.md | 2 +-
pages/windows/reg.md | 2 +-
63 files changed, 69 insertions(+), 26 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 49573373ec..6b9c2f9386 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -75,7 +75,8 @@ Many programs use subcommands for separating functionality, which may require th
For instance, `git commit` has its own page, as well as `git push` and many others.
To create a page for a subcommand, the program and subcommand need to be separated with a dash (`-`), so `git-commit.md` is shown when calling `tldr git commit`.
-You should always add a base page (e.g. `git`) that describes the program and basic switches like `--version` or `help`.
+You should always add a base page (e.g. `git`) that describes the program and basic switches like `--version` or `--help`.
+To let users know about the subcommand, add a note saying ``Some subcommands such as `example command` have their own usage documentation`` to the base page.
See these examples for reference:
* [git](pages/common/git.md)
diff --git a/pages.de/common/ansible.md b/pages.de/common/ansible.md
index b28d1cbc5c..b7e72dcfdc 100644
--- a/pages.de/common/ansible.md
+++ b/pages.de/common/ansible.md
@@ -1,7 +1,7 @@
# ansible
-> Verwalte Computergruppen per Fernzugriff über SSH.
-> Verwende die Datei `/etc/ansible/hosts`, um neue Gruppen/Hosts hinzuzufügen.
+> Verwalte Computergruppen per Fernzugriff über SSH (Verwende die Datei `/etc/ansible/hosts`, um neue Gruppen/Hosts hinzuzufügen).
+> Manche Unterbefehle wie `ansible galaxy` sind separat dokumentiert.
> Weitere Informationen: .
- Liste Hosts auf, die zu einer Gruppe gehören:
diff --git a/pages.de/common/aws.md b/pages.de/common/aws.md
index 0169225c11..06d30067a4 100644
--- a/pages.de/common/aws.md
+++ b/pages.de/common/aws.md
@@ -1,7 +1,7 @@
# aws
> Das offizielle CLI für Amazon Web Services.
-> Ausführungssassistent, SSO, Autovervollständigung von Ressourcen sowie YAML Optionen sind nur unter Version v2 verfügbar.
+> Manche Unterbefehle wie `aws s3` sind separat dokumentiert.
> Weitere Informationen: .
- Konfiguriere die AWS Kommandozeile:
diff --git a/pages.de/common/cargo.md b/pages.de/common/cargo.md
index 6d0f70954e..327a76d53b 100644
--- a/pages.de/common/cargo.md
+++ b/pages.de/common/cargo.md
@@ -1,7 +1,7 @@
# cargo
-> Rust Paketmanager.
> Verwalte Rust-Projekte und deren Abhängigkeiten (crates).
+> Manche Unterbefehle wie `cargo build` sind separat dokumentiert.
> Weitere Informationen: .
- Suche nach Abhängigkeiten (crates):
diff --git a/pages.de/common/cradle.md b/pages.de/common/cradle.md
index 59c8052613..1bef608077 100644
--- a/pages.de/common/cradle.md
+++ b/pages.de/common/cradle.md
@@ -1,7 +1,7 @@
# cradle
> Das Cradle PHP Framework.
-> Siehe `cradle-install`, `cradle-deploy`, etc. für zusätzliche Informationen.
+> Manche Unterbefehle wie `cradle install` sind separat dokumentiert.
> Weitere Informationen: .
- Stelle eine Verbindung zu einem Server her:
diff --git a/pages.de/common/docker.md b/pages.de/common/docker.md
index c27b6184de..4d1826f6bb 100644
--- a/pages.de/common/docker.md
+++ b/pages.de/common/docker.md
@@ -1,6 +1,7 @@
# docker
> Verwalte Docker Container und Images.
+> Manche Unterbefehle wie `docker run` sind separat dokumentiert.
> Weitere Informationen: .
- Liste zur Zeit laufende Container auf:
diff --git a/pages.de/common/dotnet.md b/pages.de/common/dotnet.md
index fc4f7b09b1..7a005f05b0 100644
--- a/pages.de/common/dotnet.md
+++ b/pages.de/common/dotnet.md
@@ -1,6 +1,7 @@
# dotnet
> Plattformübergreifende Kommandozeilenandwendungen für .NET Core.
+> Manche Unterbefehle wie `dotnet build` sind separat dokumentiert.
> Weitere Informationen: .
- Initialisiere ein neues .NET Projekt:
diff --git a/pages.de/common/git.md b/pages.de/common/git.md
index 8482c2297f..21b674e712 100644
--- a/pages.de/common/git.md
+++ b/pages.de/common/git.md
@@ -1,6 +1,7 @@
# git
> Verteiltes Versionskontrollsystem.
+> Manche Unterbefehle wie `git commit` sind separat dokumentiert.
> Weitere Informationen: .
- Gib die installierte Git Version aus:
diff --git a/pages.de/windows/choco.md b/pages.de/windows/choco.md
index b2482a9a49..c7be3a8759 100644
--- a/pages.de/windows/choco.md
+++ b/pages.de/windows/choco.md
@@ -1,7 +1,7 @@
# choco
> Ein Kommandozeilenwerkzeug für die Chocolatey Paketverwaltung.
-> Schau dir `choco install`, `choco upgrade` und andere Seiten für weitergehende Informationen an.
+> Manche Unterbefehle wie `choco install` sind separat dokumentiert.
> Weitere Informationen: .
- Führe einen Chocolatey-Befehl aus:
diff --git a/pages.es/common/adb.md b/pages.es/common/adb.md
index f8ac0ad403..d93d24cdfa 100644
--- a/pages.es/common/adb.md
+++ b/pages.es/common/adb.md
@@ -1,6 +1,7 @@
# adb
> Android Debug Bridge: comunica con una instancia de un emulador Android o conecta dispositivos Android.
+> Algunos subcomandos, como `adb shell`, tienen su propia documentación de uso.
> Más información: .
- Verifica si el proceso del servidor adb está ejecutandose y lo inicia:
diff --git a/pages.es/common/docker.md b/pages.es/common/docker.md
index 83965d0a19..d3c039fa95 100644
--- a/pages.es/common/docker.md
+++ b/pages.es/common/docker.md
@@ -1,6 +1,7 @@
# docker
> Administra contenedores e imágenes de Docker.
+> Algunos subcomandos, como `docker run`, tienen su propia documentación de uso.
> Más información: .
- Lista los contenedores de Docker en ejecución:
diff --git a/pages.es/common/dotnet.md b/pages.es/common/dotnet.md
index 56cea0c5a8..d5758fed7c 100644
--- a/pages.es/common/dotnet.md
+++ b/pages.es/common/dotnet.md
@@ -1,6 +1,7 @@
# dotnet
> Herramienta multiplataforma de línea de comandos para .NET Core.
+> Algunos subcomandos, como `dotnet build`, tienen su propia documentación de uso.
> Más información: .
- Inicializa un proyecto .NET nuevo:
diff --git a/pages.id/common/adb.md b/pages.id/common/adb.md
index 19ff588e3c..a2eb9d6a8c 100644
--- a/pages.id/common/adb.md
+++ b/pages.id/common/adb.md
@@ -1,6 +1,7 @@
# adb
> Android Debug Bridge: berkomunikasi dengan emulator Android atau perangkat Android terhubung.
+> Kami mempunyai dokumentasi terpisah untuk menggunakan subperintah seperti `adb shell`.
> Informasi lebih lanjut: .
- Cek apakah proses server adb telah dimulai dan memulainya:
diff --git a/pages.id/common/docker.md b/pages.id/common/docker.md
index cdd78d1946..18e39e61e7 100644
--- a/pages.id/common/docker.md
+++ b/pages.id/common/docker.md
@@ -1,6 +1,7 @@
# docker
> Mengatur kontainer Docker dan image.
+> Kami mempunyai dokumentasi terpisah untuk menggunakan subperintah seperti `docker run`.
> Informasi lebih lanjut: .
- Menampilkan semua daftar kontainer docker yang sedang berjalan:
diff --git a/pages.id/common/git.md b/pages.id/common/git.md
index 7fad0da548..c3aeb23f02 100644
--- a/pages.id/common/git.md
+++ b/pages.id/common/git.md
@@ -1,6 +1,7 @@
# git
> Sistem kontrol versi terdistribusi.
+> Kami mempunyai dokumentasi terpisah untuk menggunakan subperintah seperti `git commit`.
> Informasi lebih lanjut: .
- Memeriksa versi Git:
diff --git a/pages.id/common/pip.md b/pages.id/common/pip.md
index c16dcc7d26..5399dbf3c2 100644
--- a/pages.id/common/pip.md
+++ b/pages.id/common/pip.md
@@ -1,6 +1,7 @@
# pip
> Pengelola paket Python.
+> Kami mempunyai dokumentasi terpisah untuk menggunakan subperintah seperti `pip install`.
> Informasi lebih lanjut: .
- Memasang paket:
diff --git a/pages.id/common/vue.md b/pages.id/common/vue.md
index 414b84327b..a3b8d71462 100644
--- a/pages.id/common/vue.md
+++ b/pages.id/common/vue.md
@@ -1,6 +1,7 @@
# vue
> CLI serba guna untuk Vue.js.
+> Kami mempunyai dokumentasi terpisah untuk menggunakan subperintah seperti `vue build`.
> Informasi lebih lanjut: .
- Buat proyek vue baru secara interaktif:
diff --git a/pages.zh/common/adb.md b/pages.zh/common/adb.md
index bac0388f48..2ba4a1443e 100644
--- a/pages.zh/common/adb.md
+++ b/pages.zh/common/adb.md
@@ -1,6 +1,7 @@
# adb
> 安卓调试桥:与 Android 模拟器或已连接的 Android 设备通信。
+> 此命令也有关于其子命令的文件,例如:`adb shell`.
> 更多信息:.
- 检查 adb server 进程的是否在运行,并开启它:
diff --git a/pages.zh/common/ansible.md b/pages.zh/common/ansible.md
index f2e710cf40..59b822a13e 100644
--- a/pages.zh/common/ansible.md
+++ b/pages.zh/common/ansible.md
@@ -1,7 +1,7 @@
# ansible
-> 通过 SSH 协议远程管理计算机组。
-> 使用 `/etc/ansible/hosts` 文件来添加组 / 主机。
+> 通过 SSH 协议远程管理计算机组。使用 `/etc/ansible/hosts` 文件来添加组 / 主机。
+> 此命令也有关于其子命令的文件,例如:`ansible galaxy`.
> 主页: .
- 列出给定组下的所有主机:
diff --git a/pages.zh/common/docker.md b/pages.zh/common/docker.md
index fb5ebae62e..04b89e622b 100644
--- a/pages.zh/common/docker.md
+++ b/pages.zh/common/docker.md
@@ -1,6 +1,7 @@
# docker
> 管理 Docker 容器和镜像。
+> 此命令也有关于其子命令的文件,例如:`docker run`.
> 更多信息:.
- 列出目前正在运行的 docker 容器:
diff --git a/pages.zh/common/vue.md b/pages.zh/common/vue.md
index aae365cde4..4cf6b1247a 100644
--- a/pages.zh/common/vue.md
+++ b/pages.zh/common/vue.md
@@ -1,8 +1,7 @@
# vue-cli
> 用于初始化 Vue.js 项目的 CLI.
-> 本帮助适用于旧的 `vue-cli@2` 和 `@vue/cli-init` 插件,新版 CLI 文档请参见更多信息。
-> 官方模板包括:webpack, webpack-simple, browserify, browserify-simple, simple.
+> 此命令也有关于其子命令的文件,例如:`vue build`.
> 更多信息:.
- 从模板创建新项目:
diff --git a/pages.zh/linux/btrfs.md b/pages.zh/linux/btrfs.md
index 6f84510c44..e07c86d430 100644
--- a/pages.zh/linux/btrfs.md
+++ b/pages.zh/linux/btrfs.md
@@ -1,6 +1,7 @@
# btrfs
> 一种基于写时复制(COW)原理的 Linux 文件系统。
+> 此命令也有关于其子命令的文件,例如:`btrfs device`.
> 更多信息:.
- 创建子卷:
diff --git a/pages.zh/windows/choco.md b/pages.zh/windows/choco.md
index d128269ca4..9955e8ab48 100644
--- a/pages.zh/windows/choco.md
+++ b/pages.zh/windows/choco.md
@@ -1,7 +1,7 @@
# choco
> Chocolatey 包管理器的命令行界面。
-> 参见 `choco install`, `choco upgrade` 和其他的页面来获取额外的信息。
+> 此命令也有关于其子命令的文件,例如:`choco install`.
- 执行 Chocolatey 命令:
diff --git a/pages.zh/windows/reg.md b/pages.zh/windows/reg.md
index e17c9b1a0c..b0455e2fb9 100644
--- a/pages.zh/windows/reg.md
+++ b/pages.zh/windows/reg.md
@@ -1,7 +1,7 @@
# reg
> 用于在 Windows 注册表中管理键及其值的命令行界面。
-> 参见 `reg-query`, `reg-add` 和其他的页面来获取额外的信息。
+> 此命令也有关于其子命令的文件,例如:`reg add`.
- 执行注册表命令:
diff --git a/pages.zh_TW/common/docker.md b/pages.zh_TW/common/docker.md
index 9d8b623eba..89933a4d16 100644
--- a/pages.zh_TW/common/docker.md
+++ b/pages.zh_TW/common/docker.md
@@ -1,6 +1,7 @@
# docker
> 管理 Docker 容器和映像檔。
+> 此命令也有關於其子命令的文件,例如:`docker run`.
> 更多資訊:.
- 列出目前正在運行的 docker 容器:
diff --git a/pages/common/adb.md b/pages/common/adb.md
index 68f97d9281..d89ff948d1 100644
--- a/pages/common/adb.md
+++ b/pages/common/adb.md
@@ -1,6 +1,7 @@
# adb
> Android Debug Bridge: communicate with an Android emulator instance or connected Android devices.
+> Some subcommands such as `adb shell` have their own usage documentation.
> More information: .
- Check whether the adb server process is running and start it:
diff --git a/pages/common/amass.md b/pages/common/amass.md
index e12c8819b0..91c59a9bfc 100644
--- a/pages/common/amass.md
+++ b/pages/common/amass.md
@@ -1,6 +1,7 @@
# amass
> In-depth Attack Surface Mapping and Asset Discovery tool.
+> Some subcommands such as `amass db` have their own usage documentation.
> More information: .
- Check the Amass version:
diff --git a/pages/common/ansible.md b/pages/common/ansible.md
index 0895b53600..17704c227e 100644
--- a/pages/common/ansible.md
+++ b/pages/common/ansible.md
@@ -1,7 +1,7 @@
# ansible
-> Manage groups of computers remotely over SSH.
-> Use the `/etc/ansible/hosts` file to add new groups/hosts.
+> Manage groups of computers remotely over SSH. (use the `/etc/ansible/hosts` file to add new groups/hosts).
+> Some subcommands such as `ansible galaxy` have their own usage documentation.
> More information: .
- List hosts belonging to a group:
diff --git a/pages/common/aws.md b/pages/common/aws.md
index 88e5a7e3ae..d18fe19813 100644
--- a/pages/common/aws.md
+++ b/pages/common/aws.md
@@ -1,7 +1,7 @@
# aws
> The official CLI tool for Amazon Web Services.
-> Wizard, SSO, Resource Autocompletion, and YAML options are v2 only.
+> Some subcommands such as `aws s3` have their own usage documentation.
> More information: .
- Configure the AWS Command-line:
diff --git a/pages/common/az.md b/pages/common/az.md
index 479fc41525..fd8a3ce022 100644
--- a/pages/common/az.md
+++ b/pages/common/az.md
@@ -1,6 +1,7 @@
# az
> The official CLI tool for Microsoft Azure.
+> Some subcommands such as `az login` have their own usage documentation.
> More information: .
- Log in to Azure:
diff --git a/pages/common/bundletool.md b/pages/common/bundletool.md
index 9ff8bce98e..52f3e97848 100644
--- a/pages/common/bundletool.md
+++ b/pages/common/bundletool.md
@@ -1,6 +1,7 @@
# bundletool
> Command-line tool to manipulate Android Application Bundles.
+> Some subcommands such as `bundletool validate` have their own usage documentation.
> More information: .
- Display help for a subcommand:
diff --git a/pages/common/cargo.md b/pages/common/cargo.md
index ab65143e48..f868db0979 100644
--- a/pages/common/cargo.md
+++ b/pages/common/cargo.md
@@ -1,7 +1,7 @@
# cargo
-> Rust package manager.
> Manage Rust projects and their module dependencies (crates).
+> Some subcommands such as `cargo build` have their own usage documentation.
> More information: .
- Search for crates:
diff --git a/pages/common/conan.md b/pages/common/conan.md
index 2ee3a77bb7..6f0b269e18 100644
--- a/pages/common/conan.md
+++ b/pages/common/conan.md
@@ -1,6 +1,7 @@
# conan
> The open source, decentralized and cross-platform package manager to create and share all your native binaries.
+> Some subcommands such as `conan frogarian` have their own usage documentation.
> More information: .
- Install packages based on `conanfile.txt`:
diff --git a/pages/common/conda.md b/pages/common/conda.md
index 9390eeb3c3..76afd8587c 100644
--- a/pages/common/conda.md
+++ b/pages/common/conda.md
@@ -1,6 +1,7 @@
# conda
> Package, dependency and environment management for any programming language.
+> Some subcommands such as `conda create` have their own usage documentation.
> More information: .
- Create a new environment, installing named packages into it:
diff --git a/pages/common/consul.md b/pages/common/consul.md
index 8f6f2d429f..ab879e2974 100644
--- a/pages/common/consul.md
+++ b/pages/common/consul.md
@@ -1,6 +1,7 @@
# consul
> Distributed key-value store with health checking and service discovery.
+> Some subcommands such as `consul kv` have their own usage documentation.
> More information: .
- Check the Consul version:
diff --git a/pages/common/cradle.md b/pages/common/cradle.md
index dd6a921171..836044acf0 100644
--- a/pages/common/cradle.md
+++ b/pages/common/cradle.md
@@ -1,7 +1,7 @@
# cradle
> The Cradle PHP framework.
-> See `cradle-install`, `cradle-deploy` and other pages for additional information.
+> Some subcommands such as `cradle install` have their own usage documentation.
> More information: .
- Connect to a server:
diff --git a/pages/common/docker.md b/pages/common/docker.md
index 0128229868..7e6628c494 100644
--- a/pages/common/docker.md
+++ b/pages/common/docker.md
@@ -1,6 +1,7 @@
# docker
> Manage Docker containers and images.
+> Some subcommands such as `docker run` have their own usage documentation.
> More information: .
- List currently running docker containers:
diff --git a/pages/common/dolt.md b/pages/common/dolt.md
index 27b11672e8..58dbc09263 100644
--- a/pages/common/dolt.md
+++ b/pages/common/dolt.md
@@ -1,6 +1,7 @@
# dolt
> Dolt is an SQL database that you can fork, clone, branch, merge, push and pull just like a Git repository.
+> Some subcommands such as `dolt commit` have their own usage documentation.
> More information: .
- Execute a dolt subcommand:
diff --git a/pages/common/dotnet.md b/pages/common/dotnet.md
index 0bd669afd5..1394182d71 100644
--- a/pages/common/dotnet.md
+++ b/pages/common/dotnet.md
@@ -1,6 +1,7 @@
# dotnet
> Cross platform .NET command-line tools for .NET Core.
+> Some subcommands such as `dotnet build` have their own usage documentation.
> More information: .
- Initialize a new .NET project:
diff --git a/pages/common/drupal.md b/pages/common/drupal.md
index 7a39aa8a99..afae74e5c2 100644
--- a/pages/common/drupal.md
+++ b/pages/common/drupal.md
@@ -1,7 +1,7 @@
# drupal
-> CLI for Drupal.
-> Generates boilerplate code, interacts with and debugs Drupal projects.
+> Generate boilerplate code, interact with and debug Drupal projects.
+> Some subcommands such as `drupal check` have their own usage documentation.
> More information: .
- Install a module:
diff --git a/pages/common/dvc.md b/pages/common/dvc.md
index 0ddedd8f1c..3a83b1cc28 100644
--- a/pages/common/dvc.md
+++ b/pages/common/dvc.md
@@ -1,6 +1,7 @@
# dvc
> Data Version Control: like `git` for data.
+> Some subcommands such as `dvc commit` have their own usage documentation.
> More information: .
- Check the DVC version:
diff --git a/pages/common/fc.md b/pages/common/fc.md
index cb8e4dc1db..4ef511d12a 100644
--- a/pages/common/fc.md
+++ b/pages/common/fc.md
@@ -1,6 +1,7 @@
# fc
> Open the most recent command and edit it.
+> Some subcommands such as `fc list` have their own usage documentation.
> More information: .
- Open in the default system editor:
diff --git a/pages/common/gh.md b/pages/common/gh.md
index 09b7d314c9..ab5ad95296 100644
--- a/pages/common/gh.md
+++ b/pages/common/gh.md
@@ -1,6 +1,7 @@
# gh
> Work seamlessly with GitHub from the command-line.
+> Some subcommands such as `gh config` have their own usage documentation.
> More information: .
- Clone a GitHub repository locally:
diff --git a/pages/common/git.md b/pages/common/git.md
index ddaffb94b6..5e17b9a45b 100644
--- a/pages/common/git.md
+++ b/pages/common/git.md
@@ -1,6 +1,7 @@
# git
> Distributed version control system.
+> Some subcommands such as `git commit` have their own usage documentation.
> More information: .
- Check the Git version:
diff --git a/pages/common/gitlab.md b/pages/common/gitlab.md
index 1843720bb4..6e28b8da2c 100644
--- a/pages/common/gitlab.md
+++ b/pages/common/gitlab.md
@@ -1,6 +1,7 @@
# gitlab
> Ruby wrapper and CLI for the GitLab API.
+> Some subcommands such as `gitlab ctl` have their own usage documentation.
> More information: .
- Create a new project:
diff --git a/pages/common/go.md b/pages/common/go.md
index 95afd305b9..38cea6c817 100644
--- a/pages/common/go.md
+++ b/pages/common/go.md
@@ -1,6 +1,7 @@
# go
> Tool for managing go source code.
+> Some subcommands such as `go build` have their own usage documentation.
> More information: .
- Download and install a package, specified by its import path:
diff --git a/pages/common/hg.md b/pages/common/hg.md
index 9cd3ab307c..f4a6d8f427 100644
--- a/pages/common/hg.md
+++ b/pages/common/hg.md
@@ -1,7 +1,7 @@
# hg
> A command-line interface for Mercurial, a distributed source control management system.
-> See `hg-add`, `hg-commit` and other pages for additional information.
+> Some subcommands such as `hg commit` have their own usage documentation.
> More information: .
- Execute Mercurial command:
diff --git a/pages/common/kubectl.md b/pages/common/kubectl.md
index a2c9a48931..9b9511b5fb 100644
--- a/pages/common/kubectl.md
+++ b/pages/common/kubectl.md
@@ -1,7 +1,7 @@
# kubectl
> Command-line interface for running commands against Kubernetes clusters.
-> See also `kubectl describe` and other pages for additional information.
+> Some subcommands such as `kubectl run` have their own usage documentation.
> More information: .
- List information about a resource with more details:
diff --git a/pages/common/odps.md b/pages/common/odps.md
index 17d6d628dc..95bdfc99a6 100644
--- a/pages/common/odps.md
+++ b/pages/common/odps.md
@@ -1,6 +1,7 @@
# odps
> Aliyun ODPS (Open Data Processing Service) command-line tool.
+> Some subcommands such as `odps inst` have their own usage documentation.
> More information: .
- Start the command-line with a custom configuration file:
diff --git a/pages/common/openssl.md b/pages/common/openssl.md
index 9ef1fea34c..770a5e9194 100644
--- a/pages/common/openssl.md
+++ b/pages/common/openssl.md
@@ -1,6 +1,7 @@
# openssl
> OpenSSL cryptographic toolkit.
+> Some subcommands such as `openssl req` have their own usage documentation.
> More information: .
- Print a list of available subcommands:
diff --git a/pages/common/pio.md b/pages/common/pio.md
index 91dd57392d..dd6aad7706 100644
--- a/pages/common/pio.md
+++ b/pages/common/pio.md
@@ -1,6 +1,7 @@
# pio
> Development environment for embedded boards.
+> Some subcommands such as `pio run` have their own usage documentation.
> More information: .
- Show help and list subcommands:
diff --git a/pages/common/pip.md b/pages/common/pip.md
index 48a6fe94ee..d156c2a853 100644
--- a/pages/common/pip.md
+++ b/pages/common/pip.md
@@ -1,6 +1,7 @@
# pip
> Python package manager.
+> Some subcommands such as `pip install` have their own usage documentation.
> More information: .
- Install a package (see `pip install` for more install examples):
diff --git a/pages/common/pueue.md b/pages/common/pueue.md
index 660d22b915..dbf619a9e4 100644
--- a/pages/common/pueue.md
+++ b/pages/common/pueue.md
@@ -1,6 +1,7 @@
# pueue
> Pueue is a command-line task management tool for sequential and parallel execution of long-running tasks.
+> Some subcommands such as `pueue add` have their own usage documentation.
> More information: .
- Show general help and available subcommands:
diff --git a/pages/common/rails.md b/pages/common/rails.md
index 2c1ae24aa2..a6886f8285 100644
--- a/pages/common/rails.md
+++ b/pages/common/rails.md
@@ -1,6 +1,7 @@
# rails
> A server-side MVC framework written in Ruby.
+> Some subcommands such as `rails generate` have their own usage documentation.
> More information: .
- Create a new rails project:
diff --git a/pages/common/virsh.md b/pages/common/virsh.md
index e725ccb8a3..76ab0f5c54 100644
--- a/pages/common/virsh.md
+++ b/pages/common/virsh.md
@@ -1,7 +1,7 @@
# virsh
-> Manage virsh guest domains.
-> NOTE: 'guest_id' can be the id, name or UUID of the guest.
+> Manage virsh guest domains. (NOTE: 'guest_id' can be the id, name or UUID of the guest).
+> Some subcommands such as `virsh list` have their own usage documentation.
> More information: .
- Connect to a hypervisor session:
diff --git a/pages/common/vue.md b/pages/common/vue.md
index c70376f563..bfcec914fb 100644
--- a/pages/common/vue.md
+++ b/pages/common/vue.md
@@ -1,6 +1,7 @@
# vue
> Multi-purpose CLI for Vue.js.
+> Some subcommands such as `vue build` have their own usage documentation.
> More information: .
- Create a new Vue project interactively:
diff --git a/pages/linux/btrfs.md b/pages/linux/btrfs.md
index dfcb6e8d3a..c8b30c14f1 100644
--- a/pages/linux/btrfs.md
+++ b/pages/linux/btrfs.md
@@ -1,6 +1,7 @@
# btrfs
> A filesystem based on the copy-on-write (COW) principle for Linux.
+> Some subcommands such as `btrfs device` have their own usage documentation.
> More information: .
- Create subvolume:
diff --git a/pages/linux/dpkg.md b/pages/linux/dpkg.md
index 7560b6d7a3..2e9fc22595 100644
--- a/pages/linux/dpkg.md
+++ b/pages/linux/dpkg.md
@@ -1,6 +1,7 @@
# dpkg
> Debian package manager.
+> Some subcommands such as `dpkg deb` have their own usage documentation.
> More information: .
- Install a package:
diff --git a/pages/linux/ip.md b/pages/linux/ip.md
index 6b9b1d11df..8d0333f151 100644
--- a/pages/linux/ip.md
+++ b/pages/linux/ip.md
@@ -1,6 +1,7 @@
# ip
> Show / manipulate routing, devices, policy routing and tunnels.
+> Some subcommands such as `ip address` have their own usage documentation.
> More information: .
- List interfaces with detailed info:
diff --git a/pages/linux/nmcli.md b/pages/linux/nmcli.md
index b0b9ee41ba..0bdac543c5 100644
--- a/pages/linux/nmcli.md
+++ b/pages/linux/nmcli.md
@@ -1,6 +1,7 @@
# nmcli
> A command-line tool for controlling NetworkManager.
+> Some subcommands such as `nmcli monitor` have their own usage documentation.
> More information: .
- Run an `nmcli` subcommand:
diff --git a/pages/linux/pacman.md b/pages/linux/pacman.md
index 37902793a4..f1e1576706 100644
--- a/pages/linux/pacman.md
+++ b/pages/linux/pacman.md
@@ -1,6 +1,7 @@
# pacman
> Arch Linux package manager utility.
+> Some subcommands such as `pacman sync` have their own usage documentation.
> More information: .
- Synchronize and update all packages:
diff --git a/pages/windows/choco.md b/pages/windows/choco.md
index 707b40b193..7bcb4e1408 100644
--- a/pages/windows/choco.md
+++ b/pages/windows/choco.md
@@ -1,7 +1,7 @@
# choco
> A command-line interface for the Chocolatey package manager.
-> See `choco install`, `choco upgrade` and other pages for additional information.
+> Some subcommands such as `choco install` have their own usage documentation.
> More information: .
- Execute Chocolatey command:
diff --git a/pages/windows/reg.md b/pages/windows/reg.md
index eca5a16269..24bd2e3dd4 100644
--- a/pages/windows/reg.md
+++ b/pages/windows/reg.md
@@ -1,7 +1,7 @@
# reg
> A command-line interface for managing keys and their values in the Windows registry.
-> See `reg-query`, `reg-add` and other pages for additional information.
+> Some subcommands such as `reg add` have their own usage documentation.
> More information: .
- Execute registry commands: