Merge pull request #86 from adf-python/fix/docs-hotfix-installs

fix: Add some sentences for installing docs

Author: harrki

docs/source/install/environment/linux/install.md

@@ -2,48 +2,82 @@
 
 ## 1. Gitのインストール
 
-OS標準のパッケージマネージャーを使用してインストールします
-- DebianベースのOSの場合(Ubuntuなど)
+1. Terminalを起動し、以下のコマンドを実行します。
     ```bash
-    sudo apt install git
-    ```
-- Red HatベースのOSの場合(Fedoraなど)
-    ```bash
-    sudo yum install git
+    git --version
     ```
 
+2. もし、`command not found`などのエラーが出た場合、OS標準のパッケージマネージャーを使用してインストールします。
+    - DebianベースのOSの場合(Ubuntuなど)
+        ```bash
+        sudo apt install git
+        ```
+    - Red HatベースのOSの場合(Fedoraなど)
+        ```bash
+        sudo yum install git
+        ```
+
+        ```bash
+        sudo dnf install git
+        ```
+
+3. 以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
     ```bash
-    sudo dnf install git
+    git --version
     ```
 
 ## 2. Pythonのインストール
 
-OS標準のパッケージマネージャーを使用してインストールします
-- DebianベースのOSの場合(Ubuntuなど)
-    ```bash
-    sudo apt install python
-    ```
-- Red HatベースのOSの場合(Fedoraなど)
+1. Terminalを起動し、以下のコマンドを実行します。また、バージョンが3.12以上になっていることを確認します。
     ```bash
-    sudo yum install python
+    python --version
+    # OR
+    python3 --version
     ```
 
+2. もし、`command not found`などのエラーが出た場合やバージョンが低い場合、OS標準のパッケージマネージャーを使用してインストールします
+    - DebianベースのOSの場合(Ubuntuなど)
+        ```bash
+        sudo apt install python3.12 python3.12-pip
+        ```
+    - Red HatベースのOSの場合(Fedoraなど)
+        ```bash
+        sudo yum install python3.12 python3.12-pip
+        ```
+
+        ```bash
+        sudo dnf install python3.12 python3.12-pip
+        ```
+
+3. 以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
     ```bash
-    sudo dnf install python
+    python --version
+    # OR
+    python3 --version
     ```
 
 ## 3. OpenJDKのインストール
 
-OS標準のパッケージマネージャーを使用してインストールします
-- DebianベースのOSの場合(Ubuntuなど)
-    ```bash
-    sudo apt install openjdk-17-jdk
-    ```
-- Red HatベースのOSの場合(Fedoraなど)
+1. Terminalを起動し、以下のコマンドを実行します。また、バージョンが17になっていることを確認します。
     ```bash
-    sudo yum install java-17-openjdk
+    java --version
     ```
 
+2. もし、`command not found`などのエラーが出た場合やバージョンが異なる場合、OS標準のパッケージマネージャーを使用してインストールします
+    - DebianベースのOSの場合(Ubuntuなど)
+        ```bash
+        sudo apt install openjdk-17-jdk
+        ```
+    - Red HatベースのOSの場合(Fedoraなど)
+        ```bash
+        sudo yum install java-17-openjdk-devel
+        ```
+
+        ```bash
+        sudo dnf install java-17-openjdk-devel
+        ```
+
+3. 以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
     ```bash
-    sudo dnf install java-17-openjdk-devel
+    java --version
     ```

docs/source/install/environment/mac/install.md

@@ -1,21 +1,61 @@
 # Macでの環境構築
+## 1. Homebrewのインストール
+1. Terminalを起動し、以下のコマンドを実行します。
+    ```bash
+    brew -v
+    ```
+
+2. もし、`command not found`などのエラーが出た場合、以下のコマンドを実行します。
+    ```bash
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+    ```
+
+3. もう一度、以下のコマンドを実行してバージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
+    ```bash
+    brew -v
+    ```
 
-## 1. Gitのインストール
+## 2. Gitのインストール
 
-1. Terminalを起動します。
-2. XcodeのCommand Line Toolsをインストールします。
+1. Terminalを起動し、以下のコマンドを実行します。
+    ```bash
+    git --version
+    ```
+2. もし、`command not found`などのエラーが出た場合、以下のコマンドを実行します。
+    ```bash
+    brew install git
+    ```
+3. 以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
     ```bash
-    xcode-select --install
+    git --version
     ```
 
-## 2. Pythonのインストール
+## 3. Pythonのインストール
 
-1. [Python](https://www.python.org/downloads/)の公式サイトにアクセスします。
-2. ダウンロードページから最新のバージョンをダウンロードします。
-3. ダウンロードしたファイルを開き、インストールを開始します。
+1. Terminalを起動し、以下のコマンドを実行します。また、バージョンが3.12以上になっていることを確認します。
+    ```bash
+    python --version
+    ```
+2. もし、`command not found`などのエラーが出た場合やバージョンが低い場合、以下のコマンドを実行します。
+    ```bash
+    brew install python
+    ```
+3. 以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
+    ```bash
+    python --version
+    ```
 
 ## 3. OpenJDKのインストール
 
-1. [OpenJDK](https://jdk.java.net/archive/)の公式サイトにアクセスします。
-2. ダウンロードページから17.0.2のバージョンをダウンロードします。
-3. ダウンロードしたファイルを開き、インストールを開始します。
+1. Terminalを起動し、以下のコマンドを実行します。また、バージョンが17になっていることを確認します。
+    ```bash
+    java --version
+    ```
+2. もし、`command not found`などのエラーが出た場合やバージョンが異なる場合、以下のコマンドを実行します。
+    ```bash
+    brew install openjdk@17
+    ```
+3. 以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
+    ```bash
+    java --version
+    ```