使用 JavaDoc 记录 Map 的标准方法是什么？

我正在记录一些代码，并且我有一个私有 HashMap。我想指定有关键和值的期望信息。现在我有：

/**
 * HashMap where key=word, value=part of speech
 */
private HashMap<String, String> dictionary;

然而，这似乎很难阅读，而且当我有更复杂的东西时，它也不会很好地工作，比如

HashMap<String, HashMap<String, String>>

记录地图的最佳/常见做法是什么？

如果您需要一个小的 javadoc，我建议如下：

/**
 * Dictionary is a {@link Map} collection that contains {@link Object1} as
 * key and {@link Object2} as value.
 */
private Map<Object1, Object2> dictionary = new HashMap<>();

@link keywork 将在实例定义上重定向您。

注意：应优先使用接口作为类型（Map 而不是 HashMap）。