連想配列を引数に用いた時のDocコメントの書き方

Question

次の様に引数に連想配列を用いた時のDocコメントはどの様に書くのが適切なのでしょうか？

/**
 * 関数の説明
 *
 * @param associative array 引数の名前 引数の説明
 * 引数の指定が無いので引数の名前が書けない…
 * 連想配列の中身の説明はどの様に書けば…
 */
function func() {
    // 初期値
    $initial_args = array(
        'abc' => null,
        'def' => false,
        'ghi' => array(
            'one' => 10,
            'two' => 'string'
        )
    );

    // 引数を取得
    $args = func_get_args();
    $args = $args[0];

    // 処理内容
}

Answer 1

次の様な書き方に落ち着きました

参考: WordPress › PHP Documentation Standards « Make WordPress Core

/**
 * 概要
 *
 * 説明
 * 必須のパラメータ以外は省略可能
 *
 * @param array {
 *     以下の各要素を格納した連想配列(必須) Default 'abc', 'def', 'ghi'
 *
 *     @type string 'abc' 説明(必須) Default null.
 *     @type bool 'def' 説明 Default false.
 *     @type array 'ghi' {
 *         以下の各要素を格納した連想配列 Default 'one', 'two'
 *
 *         @type integer 'one' 説明 Default 10.
 *         @type string 'two' 説明 Default 'string'.
 *     }
 * @return データ型 戻り値 説明
 */