Hi, Stef
I have an idea for this problem,
1. method should have it's comment like class comment
2. method comment has two versions, one for developer another for reader
3. developder's comment will be saved in source or changes file
4. reader's comment will be saved in its own file
5. system browser can load reader's comment of method when you want to read or write
reader can write his comment using his native language, we can share all reader's comments on internet.
Best regards
Bing Liang