[DOC] add guildelines on type hints

[ahms5]

Maybe we should decide whether to require type hints or not.
Once we reach a decision, it should be added to the documentation guidelines.