Must be a matter of preference but this is exactly what I hate about godoc. I'd love to use markdown or any other structure, really. Just a wall of plain text is sometimes good, but most of the time bad idea for readability. And the idea of starting each godoc comment with function/variable name is terrible. YMMV.
I beg to disagree. About Japanese society and cooping strategies, that is.
I let myself to generalize a bit and say that most of the people on the spectrum feels well in more or less rigid, closed set of social rules. The more logical the better. In reality, a lot of awkwardness comes from the fact that daily human to human behavioral protocol is very open. Anything may happen and it feels overwhelming just to think about all the possibilities a conversation may leads to.
Japanese society is normalized to the point that the citizens may feel upset just by the fact that they are in certain situation and there is no how-to around. People are following social rules everywhere. Japanese society is strictly formalized and everyone is expected to behave properly in given situation. You go to restaurant and you don't have to wonder how much should you tip to the waiter. You don't tip. Simple as that - that's the rule. They've made a lot practical improvements to make the daily struggle as easy as possible. They are always avoiding conflict. When someone step on someone's shoe in metro they say "sorry" (both of them!) and go on. There is no ambiguity in your daily life.
More of it. Being socially awkward is perfectly acceptable or at least tolerated. I am talking about bigger cities, of course. You can walk the streets of Shibuya in a diving suit and no one would say a word. You can refrain from talking to people, too.
They are, almost naively, honest and even Tokyo - 38M people, 13M in the city - is so safe, that you can leave your bag to reserve a table in the crowded fast food and go to the counter to make an order. No one will take it. No one will abuse you and you don't have a reason to feel vulnerable.
If there's a rule, so it is. People are obeying the law and keeping to the rules. This is extremely safe environment for people on the spectrum.
One thing that is usually omitted in any analysis is the weather. Seems non important. But if we consider that ASD is commonly accompanied by depression and/or anxiety I'm willing to weight a weather as a factor. The thing is that winter is almost non existent in Tokyo and to the south. But, what is more important, there is sunny all year long. All year long you have something in the air that will brighten up your day. Just imagine that - plum trees are blooming in February. November and full sun so you can wear t-shirt and hoodie? Go ahead, at least in Tokyo. Much easier to keep in good shape then, say, in London when most days are gloomy.
Of course no country's perfect. What I've said above is the norm, but there are always some exceptions. Big cities are loud and bright. Sensory issues may be problematic. Some rules are less logical that it seems. Japanese language is not direct and sometimes people are expected to notice when should they react.
I do agree that Japan is not country for everyone but as long as ASD goes I'd rather say it is better suited for people on the spectrum that we may suspect. Especially for foreigners as we are naturally allowed to make mistakes.
It is not an idiom. Idiom conveys a meaning even if not literal. "How are you" plays a social role, but doesn't have any meaning. There is a linguistic construct called "phatic expression" and it seems much more accurate.