Merge docs updates.

Author: ohmurayu

README.md

@@ -209,7 +209,7 @@ The contents of this setting are as follows.
 
 > NOTE: See the following explanation for how to use Context
 >
-> - [Manage personal environment by cdk.context.json](doc/HowTo.md#cdkcontextjson-Manage-personal-environment)
+> - [Manage personal environment by cdk.context.json](doc/HowTo.md#Manage-personal-environment-by-cdkcontextjson)
 >
 > - [Accessing context in application](doc/HowTo.md#accessing-context-in-application)
 
@@ -352,7 +352,7 @@ This completes the baseline and sample application deployment for a single accou
 From now on, you will use this sample code as a starting point to develop applications tailored to your use case. Indicates information necessary for general development.
 
 - [Development process](doc/HowTo.md#development-process)
-- [Update package dependencies](doc/HowTo.md#update-dependencies)
+- [Update package dependencies](doc/HowTo.md#update-package-dependencies)
 
 #### 5-4. Remediation of security issues
 

doc/DeployToControlTower.md

@@ -263,7 +263,7 @@ The contents of this setting are as follows.
 
 > NOTE: See the following explanation for how to use Context
 >
-> - [Manage personal environment by cdk.context.json](doc/HowTo.md#cdkcontextjson-Manage-personal-environment)
+> - [Manage personal environment by cdk.context.json](doc/HowTo.md#Manage-personal-environment-by-cdkcontextjson)
 >
 > - [Accessing context in application](doc/HowTo.md#accessing-context-in-application)
 
@@ -493,7 +493,7 @@ This completes the baseline and sample application deployment for a single accou
 From now on, you will use this sample code as a starting point to develop applications tailored to your use case. Indicates information necessary for general development.
 
 - [Development process](doc/HowTo.md#development-process)
-- [Update package dependencies](doc/HowTo.md#update-dependencies)
+- [Update package dependencies](doc/HowTo.md#update-package-dependencies)
 
 #### 7-4. Remediation of security issues
 

doc/HowTo.md

@@ -7,10 +7,10 @@ Here we will describe howTo for various settings.
 - [VisualStudioCode Setup Instructions](#VisualStudioCode-Setup-Instructions)
 - [Git pre-commit hook setup](#Git-pre-commit-hook-setup)
 - [Skip Deployment Approvals and Don't Roll Back](#skip-deployment-approvals-and-dont-roll-back)
-- [Manage personal environment by cdk.context.json](#cdkcontextjson-Manage-personal-environment)
+- [Manage personal environment by cdk.context.json](#Manage-personal-environment-by-cdkcontextjson)
 - [Set up Slack for AWS ChatBot](#set-up-slack-for-aws-chatbot)
 - [Deployment with CloudShell](#deployment-with-cloudshell)
-- [Update package dependencies](#update-dependencies)
+- [Update package dependencies](#update-package-dependencies)
 - [Accessing context in application](#accessing-context-in-application)
 - [Development process](#development-process)
 - [Remediate Security Issues](#remediate-security-issues)
@@ -39,7 +39,7 @@ For macOS, select [Running Visual Studio Code on macOS](https://code.visualstudi
 
 If you clone this repository in a subsequent step and open it in VSCode, you will be prompted to install the recommended extension. Now click on _Install_.
 
-! [vscode-recommended-extensions](doc/images/VSCode-Recommended-Extensions.jpg)
+![vscode-recommended-extensions](../doc/images/VSCode-Recommended-Extensions.jpg)
 
 This recommended extension is defined in `.vscode/extensions.json`. For more information about this feature, see [Managing Extensions in Visual Studio Code](https://code.visualstudio.com/docs/editor/extension-marketplace#_workspace-recommended-extensions).
 
@@ -340,6 +340,14 @@ If your CDK code requires additional packages, install them as follows: Here we
 > ```
 
 > NOTE:
+> When you update a CDK source code, your snap shot test (npm run test) will be failed because a generated template is differ from previous one.
+> If your CDK code is correct, you need to update a snapshot using command below.
+>
+> ```sh
+> # Update snapshot
+> npm run test -- -u
+> ```
+>
 > To build all use cases, run the following using workspaces:
 >
 > ```sh
@@ -349,6 +357,7 @@ If your CDK code requires additional packages, install them as follows: Here we
 > npm run format
 > npm run clean --workspaces
 > npm run build --workspaces
+> npm run test --workspaces -- -u      # update snaphosts
 > npm run test --workspaces
 > ```
 >

doc/HowTo_ja.md

@@ -39,7 +39,7 @@ macOS の場合、 [Running Visual Studio Code on macOS](https://code.visualstud
 
 後続の手順でこのリポジトリを clone して VSCode で開くと、推奨 Extension のインストールを促されます。ここで _Install_ をクリックます。
 
-![VSCode-Recommended-Extensions](doc/images/VSCode-Recommended-Extensions.jpg)
+![VSCode-Recommended-Extensions](../doc/images/VSCode-Recommended-Extensions.jpg)
 
 この推奨 Extension は `.vscode/extensions.json` で定義されています。この機能の詳細は [Managing Extensions in Visual Studio Code](https://code.visualstudio.com/docs/editor/extension-marketplace#_workspace-recommended-extensions) をご参照ください。
 
@@ -335,12 +335,20 @@ CDK コードで追加のパッケージが必要になった場合は、以下
 > npm run format
 > # build
 > npm run build
-> # snapshot test
+> # snapshot test (see NOTE)
 > npm run test
 > ```
 
 > NOTE:
 >
+> CDK コードを変更した場合、以前とは異なるテンプレートが生成されるため、スナップショットテスト (npm run test) が失敗します
+> テンプレートが正しく生成されているならば、次のようにスナップショットの更新が必要です。
+>
+> ```sh
+> # Update snapshot
+> npm run test -- -u
+> ```
+>
 > 全てのユースケースをビルドするには workspaces を使用して次のように実行します。
 >
 > ```sh
@@ -350,6 +358,7 @@ CDK コードで追加のパッケージが必要になった場合は、以下
 > npm run format
 > npm run clean --workspaces
 > npm run build --workspaces
+> npm run test --workspaces -- -u      # update snaphosts
 > npm run test --workspaces
 > ```
 >