@Bertram25 The problem with writing docs in the header is that the header is no longer a light file at all. In over 90% of the cases our documentation is superfluous and leaving it out in the header file makes sure the API of most classes will fit on one page. In the same spirit we no longer write inline functions in the class definition.

For an example see https://github.com/mana/manaserv/blob/master/src/game-server/entity.h#L44