Zitat Zitat von Morden Beitrag anzeigen
Und apropos RGSS - schaut euch den originalen RGSS-Quelltext an, der ist auch komplett kommentiert und dokumentiert…
Wobei die Kommentare ein gutes Beispiel dafür sind, wie man es eigentlich nicht machen sollte, weil sie in der Regel so aussehen:
Code: 
#--------------------------------------------------------------------------
# * Remove Actor
#     actor_id : actor ID
#--------------------------------------------------------------------------
def remove_actor(actor_id)
  # Delete actor
  @actors.delete($game_actors[actor_id])
  # Refresh player
  $game_player.refresh
end

Das fällt genau in die Kategorie von unnötigem Kommentar, die Corti irgendwo weiter oben angesprochen hat. Es sollte z. B. eigentlich offensichtlich sein, dass $game_player.refresh höchstwahrscheinlich genau das tut: Das Spieler-Objekt refreshen. Andernfalls hat man bei der Methoden-Bennenung was falschgemacht.

Und bei komplexeren Dingen, bei denen man sich eine Erklärung wünschen würde, steht dann hingegen meist garnichts o_o