Если моя функция возвращает например словарь, название ключей которого есть стандартным
То как точно описать возвращаемую структуру данных а не просто dict?

Если бы Вы были автором языка, как бы Вы это реализовали?

FishHook
Если бы Вы были автором языка, как бы Вы это реализовали?

Если бы я был автором языка то сделал бы так как мне нравиться или так как нравиться тому кто платит деньги за развитие языка.

Но меня интересует общепринятый стандарт документирования (что бы меня поняли другие разработчики).

http://sphinx-doc.org/
не то чтобы стандарт, но близко к этому.