Things are stalled no because of the Holidays. You are looking at only
about 2-3 days of of 1-hour per day effort. It wouldn't hurt to wait
for a few days when people are better able to contribute.
Brennan and Nathan have been the sole "authors" of the document. I have
not been directly contributing because I wanted to avoid the "too many
chefs" problem. So I have only been adding suggested content as
comments that can be addresses, or not, depending on the intent of the
authors.
Hopefully, if enough enough eyes and brains work the document we will
have assured PPMC agreement.
Greg
On 12/26/2019 8:51 AM, Anthony Merlino wrote:
Hi all,
I would like to propose a method of collaboration for the workflow
requirements. Nathan and Brennan have done some legwork that is now on the
Wiki - which is a great starting point. Unfortunately, it hasn't seen much
collaboration other than a few comments.
I believe part of the issue here is that no one wants to go in and change
someone else's proposal. The wiki is also not the most friendly to use for
collaboration and has no method of tracking changes (at least to my
knowledge).
I have started a CONTRIBUTORS.md file in a personal fork of incubator-nuttx:
https://github.com/antmerlino/incubator-nuttx/blob/antmerlino-contributors-md/CONTRIBUTORS.md
For those not familiar, CONTRIBUTORS.md is a common file found in many
other open source projects that tells interested parties how to contribute
to the project. It is essentially the workflow document.
I have asked David to show me the ropes of suggesting changes in the Github
UI. The suggested changes land as separate commits, which allows us to
track changes and authorship while developing this document. You can also
pull the repo, make changes, and open a PR against the branch too, if you
don't want to work in Github. Of course we can squash it all together at
the end when/if we merge it in. This is a much more collaborative way of
working. We can make comments in context, see what others are suggesting,
and integrate that feedback quickly into the deliverable. Otherwise we are
waiting for some poor soul to do 90% of the work themselves and then do the
extra 10% work of integrating people's feedback from the emails. That's not
a good collaboration method.
If others are keen on this idea, I propose that we move this branch and PR
from my personal fork, to the incubator-nuttx repository, collaborate on
the PR, and land when we are all happy. Based on the discussion here, I
will call a vote to move the PR and branch.
Best,
Anthony
