fights bit rot in macro docs #378
Conversation
|
Eugene, thanks to Shimamoto-san's presentation, I've found a number of very important omissions and obsolete statements in current macro docs. I've fixed those in the English version, but what bothers me is that the Japanese version that still has the problems. I'm very grateful to you for providing the initial Japanese translations, and by no means I want to impose the burden of updating them onto you. Therefore, maybe we could just archive the existing translations for the time being? What do you think? |
|
From the Japanese reader's point of view document going offline when there's a gap between the original is very inconvenient, so maybe the middle way would to put up a sign at the top of the document saying it's currently obsolete for 2.11|12/paradise/scala.meta etc. If it's not too much work, I don't mind translating once in a while. Another thing we should try is to advertise that the translation resource is wanted on scalajp list, when I'm too busy. ScalaMatsuri had 300+ people listening to Martin's talk in Japan. I'm sure there are a few who would be happy to lend their Japanese language power for macros (or any other official docs). |
|
I'm concerned about some parts of the content being plain wrong in the current state of things. Even if we put the deprecation notice, I fear that some people might ignore it (or legitimately not see it if they use a permalink to navigate to a portion of page). Do you think that might be a problem? Thanks for your kind offer! How about then we first go for a post at scalajp, because the volume of the docs probably doesn't qualify for "not too much work", even if you only count the delta. Afterwards, I will put you in /cc of my documentation pull requests, and those tend to be reasonably small. WDYT? |
|
Allright, I think I'll merge this for now, and if our discussion concludes with a need in submitting a follow-up pull request, I'll do that separately. |
|
I'll try to bring the macro translations up to date in a week or two. |
|
Thank you! |
|
Started working on this here - https://github.com/eed3si9n/scala.github.com/commits/topic/tracking-macros. I'm caught up to November 16th, 2013. |
review @eed3si9n