Revise contributing guidelines for code standards

Author: tas0dev

CONTRIBUTING.md

@@ -3,7 +3,7 @@ LiteCore Kernelをコーディングする際に、できるだけ守ってほ
 
 ### 基本
 #### インデントは8です。
-4じゃないと見づらい、という人がいるかもしれませんが、それはコードの問題です。私の思う限り、インデントはコードブロックを見やすくするためのものなはずです。インデントが多くて見づらいコードは、つまりブロックが多すぎます。減らしましょう。折返しがされないくらいが程よいと思います。
+4じゃないと見づらい、という人がいるかもしれませんが、それはコードの問題です。私の思う限り、インデントはコードブロックを見やすくするためのものなはずです。インデントが多くて見づらいコードは、つまり入れ子となっているブロックが多すぎます。減らしましょう。折返しがされないくらいが程よいと思います。
 
 #### コメントは日本語か英語で書いてください
 私は日本語話者ですが、英語でのコメントも良いと思います。ただし、一つのファイル内では統合してください。
@@ -43,7 +43,7 @@ int load_config(void);
 const char* get_config_value(const char* key);
 void build_compile_command(void);
 ```
-Rustのようにかっこよさを求める必要はありません。質
+どこぞのモダン言語のようにかっこよさを求める必要はありません
 
 #### 定数（#define）は UPPER_SNAKE_CASE を使用してください
 ```c
@@ -89,7 +89,7 @@ if (value == NULL) {
 ### コメント
 
 #### Doxygenコメント
-各ファイル、関数、定数、構造体にはDoxygenコメントをつけてください。
+最低限、関数/定数/構造体にはドキュメントコメントをつけてください。
 
 #### その他のコメント
 コメントを書くのはとてもいいことですが、書きすぎないでください。
@@ -117,26 +117,17 @@ char files[MAX_FILES][256];  // サイズが明確
 
 #### ヘッダーファイルにはインクルードガードを使用してください
 ```c
-#ifndef LITECORE_CONFIG_H
-#define LITECORE_CONFIG_H
+#ifndef _CONFIG_H
+#define _CONFIG_H
 
 // 宣言...
 
-#endif /* LITECORE_CONFIG_H */
-```
-
-#### 各ファイルの先頭にはファイルの説明を書いてください
-```c
-/**
- * @file config.c
- * @brief 設定ファイルの読み込み機能
- * @details .configファイルを解析してビルド設定を取得します
- */
+#endif /* _CONFIG_H */
 ```
 
 ### 関数の設計
 
-#### 関数は一つのことだけを行うようにしてください
+#### 関数は一つのことだけを行うようにしてください（ただし、それらを行うことでわかりやすくなる場合は別です）
 ```c
 // 良い例：単一責任
 int count_c_files(const char* dir_path);
@@ -146,7 +137,7 @@ int load_file_list(const char* dir_path, char files[][256]);
 int count_and_load_files(const char* dir_path, char files[][256]);
 ```
 
-#### 関数の引数は5個以下にしてください
+#### 関数の引数は可能な限り少なくしてください
 引数が多い場合は、構造体を使用することを検討してください。
 
 ```c
@@ -162,9 +153,7 @@ void build_command(const build_config_t* config, char* command);
 ```
 
 ### テストとデバッグ
-
-#### デバッグ用のprintfは本番コードから削除してください
-デバッグが必要な場合は、`debug()`関数を使用してください
+テストはすべてinclude/tests/define.h, src/tests/run.cと既存のテストを読んで追加してください。ある程度のプログラマであれば、書き方がわかるはずです。
 
 ### コードレビュー
 
@@ -178,4 +167,4 @@ void build_command(const build_config_t* config, char* command);
 あなたが夜寝て、スッキリした後にそのコードを見たとき、すぐに理解できるかどうかを考えてください。
 
 ## 最後に
-このガイドラインは絶対的なものではありません。プロジェクトの要求や状況に応じて、適切に判断して使用してください。重要なのは、一貫性とチーム全体での合意です。
+このガイドラインは絶対的なものではありません。プロジェクトの要求や状況に応じて、適切に判断して使用してください。重要なのは、一貫性とコミュニティ全体での合意です。