Документация для Go format
пакета гласит:
Обратите внимание, что форматирование Go исходного кода со временем меняется.
Как это происходит? У меня есть определенное c незначительное изменение, которое я хотел бы пройти мимо сообщества. Чтобы быть ясным, я рад, что у сообщества есть стандарт, и я не пытаюсь справиться с ним. Наоборот, я хотел бы знать, что санкционированное средство означает предлагать изменения, чтобы их можно было рассмотреть.
Для любопытных я хотел бы предложить следующее:
// Great is a really great function.
func Great(
anArg int, // This explains anArg
anotherArg string, // This explains anotherArg
) (err error) {
...
в противоположность этому:
// Great is a really great function.
func Great(
anArg int, // This explains anArg
anotherArg string, // This explains anotherArg
) (err error) {
...
Мне кажется, что это будет более соответствовать:
var (
aVar = 12 // This explains aVar
anotherVar = "something" // This explains anotherVar
)
или
type SomeStruct struct {
FieldName string
Value int
}
var aStructList = []*SomeStruct {
{
FieldName: "SomeName", // Comment for FieldName
Value: 12, // Comment for Value
},
}