add src/pkg/go/build/doc.go #54

[ucho]

#54

見出しを日本語で書くと見出しにならない(#15)ようなので、
ひとまず見出しは原文のままにしました。

[atotto]

#15 の件ですね。こちらの件はまだ手を入れられてません。。

review:

• 基く → 基づく が正しいようです
  • http://dictionary.goo.ne.jp/leaf/jn2/219627/m0u/%E3%82%82%E3%81%A8%E3%81%A5%E3%81%8F/
• 下とつながるコロン":"はそのまま残してください
  • 例 : https://github.com/gophersjp/go/blob/master/src/cmd/gofmt/doc.go#L62
  • ＃このへんルールに書いてないですね・・・
• 中途半端なところで改行している文は改行を消してください
  • NGな所の例: https://github.com/gophersjp/go/pull/57/files#diff-87daa15dad0c80ab3371912b467822ceR10
  • NGな所の例: https://github.com/gophersjp/go/pull/57/files#diff-87daa15dad0c80ab3371912b467822ceR66
  • OKな所: https://github.com/gophersjp/go/pull/57/files#diff-87daa15dad0c80ab3371912b467822ceR63
  • OKな所: https://github.com/gophersjp/go/pull/57/files#diff-87daa15dad0c80ab3371912b467822ceR21

細かいところですみませんが、よろしくお願いします。

[ucho]

ご指摘ありがとうございます。修正しました。

改行についてですが、1行が80文字を超えてもかまわないということでしょうか？
どうもオリジナルは80文字ルールでやっているようだったので…。

もし1行の文字数を制限しないのであれば、なるべく改行を入れない方がよいかもしれません。
改行はgodocでスペースに変換されているように見えるので、なんか気持ち悪いです…。

[atotto]

修正ありがとうございます！

html上の改行はスペースになってしまいますので、適当な場所で改行すればいいかなと思ってます。
１行にまとめていただいても構わないのですが、長いと差分が見づらい等々・・・という感じです。

uchoさんがよければマージしちゃいます。

[ucho]

はい、マージしていただいてOKです。