Как определить экземпляры в Javadoc или псевдокоде?

Question

У меня возникает соблазн написать что-то следующее:

StringBuilder.append(String.format("%d %f", x, y));

Но я знаю, что я действительно работаю с экземпляром StringBuilder, и я не хочу вызывать статический метод добавления.Есть ли обычно практикуемый способ написания такого Javadoc или псевдокода?

Answer 1

Мне нравится писать StringBuilder#append(...) здесь, чтобы указать, что это метод экземпляра, который вызывается на экземпляре StringBuilder, а не метод класса (статический), в отличие от метода класса, подобного String.valueOf(...).

Я не уверен, что есть определенное соглашение об этом, хотя.