On 2018/10/23 2:33, Taylor R Campbell wrote:
Date: Mon, 22 Oct 2018 22:28:35 +0900
From: Rin Okuyama <rokuy...@rk.phys.keio.ac.jp>
I'm really disappointed by this. I do not like the way you got things
going (and also I really do not like to write a message like this).
I asked you to discuss further before rashly committing it. Didn't I?
People actually provided some useful proposals to improve your draft.
However, instead of finding a point of agreement, you shutted down
discussion one-sidedly:
https://mail-index.netbsd.org/tech-toolchain/2018/10/10/msg003307.html
Hi, Rin!
There are some good suggestions in that thread, and parts of the
thread became a bit of a bike shed. We don't have a formal review
process for evolving changes before merging them into HEAD (though we
may be moving toward one with hg).
Perhaps it would have been better to see another iteration or two of
drafts, but (a) bike shed discussions can be long and tedious and can
discourage contributions, and (b) we can always revise README.md as a
living document -- no need to revert altogether when we can just edit
it to improve it.
Well, it makes sense on one hand. But, on the other hand, your argument
can be very dangerous if it is abused; I really hate an attitude like
"Oh, discussion is falling into a bike shed! Let's commit it to shut them
up!" Of course, I do understand you are not a person to do such a thing.
However, I believe that we must prove it, we do not behave like that, by
our daily actions. Otherwise, the community will break up. This is why
I'm writing this sequence of unpleasant messages which must "discourage"
everyone --- I am really sorry for it.
So, what would you like to see improved in the document?
- We should definitely mention the relation of the mirror on Github to
the master version in CVS.
- We can pick a standard style for the capitalization of example
architecture names, or pick a different selection of them that
doesn't make capitalization difficult, or change all of them.
- We can tweak the suggested build.sh incantation, and expand on what
the parts of it mean. Personally I use `../obj.amd64' instead of
`~/obj'.
Yes, we must explain the relation between CVS master and GitHub mirror,
at least. Others are minor problems although I feel it better to be
consistent with our existing documents. For example, architecture
names in http://wiki.netbsd.org/ports/ are not capitalized at all.
rin
P.S.
Maya, why don't you express your opinion in a public ML instead of
sending a private massage to me? Rather, let us get back to technical
discussions...
