title: Should I use @return self, this or the current class?
body: <p>I have a method that return the current object, how do I document this?</p>
  
  <pre><code>/**
   * set something
   *
   * @return this
   */
  public function setSomething(){
              // ...
      return $this;
  }
  </code></pre>
  
  <p>Or should I do <code>@return self</code> or <code>@return Current_Class_Name</code>?</p>
  
  <hr>
  
  <p>Reason why this question is not "primarily opinion-based" (and should be reopened): conformance to standards and IDE type hinting support.</p>