Realmente, eu concordo com você, eu mesmo tenho um serio problema com documentação, algumas documentações ao meu ver são muito dificeis de entender pelo menos para mim, eu fico perdido dentro da documentação do GTK, tento aprender mas é bem complicado, estou acostumado com documentação com exemplos estilo PHP, ontem mesmo que eu fui entender uma parte da DOC do GTK vendo live do Georges Stavracas, mas tem algumas DOC que eu tenho problemas de achar as coisas e outras de compreender o que o codigo faz, exemplo: this.abrirJanela(fechadura(CHAVE_EM_CIMA_MESA)) o codigo poderia ser assim ou assim this.abrirJanela().fechadura(CHAVE_EM_CIMA_MESA), fico meio confuso nessas partes.
1