Re: CVS commit: src

[Rin Okuyama <rokuyama%rk.phys.keio.ac.jp@localhost>]

On 2018/10/23 2:33, Taylor R Campbell wrote:
> > Date: Mon, 22 Oct 2018 22:28:35 +0900
> > From: Rin Okuyama <rokuyama%rk.phys.keio.ac.jp@localhost>
> >
> > 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...