You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
For the last few months, myself and now several other contributors including @ripcurlx, @alexej996 and @mrosseel have been writing monthly report comments on our respective role issues.
I am proposing here that every primary role owner write a monthly report comment on the role(s) that they own (see #12 regarding the distinction between primary and secondary role owner).
The reasons for this are several:
These reports are a great way to share information with other contributors and with the Bisq community at large about the things you're responsible for. Anyone can click the "Subscribe" button on any role issue (or indeed can Watch the entire bisq-network/roles repository), and get regular updates about whichever roles they care about. This is a fundamentally scalable approach to information sharing.
These reports serve as a basic kind of "heartbeat" message from role owners, letting the network (of other contributors) know that they are in fact on top of their duties, or at least that they are not obviously derelict in their duties. If there is nothing to report on a given month, just say "Nothing to report". The important thing there is that you are reporting in the first place, and in doing so, letting folks know "all is well with this role" (and that you should indeed be compensated for performing the duties of that role).
Doing reports this way makes compensation requests easier to write and easier to evaluate. Where roles are involved, compensation requests should consist of nothing more than a set of links to monthly role updates. For an example of how this looks in practice, see my own compensation requests, e.g. Adding specification for the forum operator role roles#57 and Analytics Maintainer roles#40. This way, you can say as much or as little about your roles as you like in the monthly reports for each, and then simply link to that report comment from your compensation request. This makes it easier for stakeholders to evaluate compensation requests during voting as well, because they know that compensation requests are mostly "thin" documents consisting of links to more substantive reports that follow a common format. This way we don't have to parse every contributors different, idiomatic approach to writing compensation requests.
So, to re-iterate: I propose that every primary role owner start writing monthly report comments starting with the next round of compensation requests that we will vote on from May 1–3rd.
If we have a rough consensus on this proposal by that time, I will vote 0 for any proposal that does not include monthly report comments in May, and I will vote -1 for any proposal that does not include them in June and beyond.
Also, I propose we continue with the format that has emerged for these comments, which is as follows:
## 2018.03 report
[primary role owner's notes, observations, data as they see fit]
/cc bisq-network/compensation#42
Where the date obviously changes with each month, and the linked compensation issue is that role owner's current (draft) compensation request for the month. You can see the effect that this kind of round-trip referencing has between roles and compensation requests by looking at my request for this month at bisq-network/compensation#57.
I wanted to get this proposal together now, just as our May voting is finishing up, so everybody has plenty of time to consider it prior to the next voting round. Thanks, all.
(See also this month's Roles Maintainer role update, where I first suggested that we institutionalize this process of writing monthly updates: bisq-network/roles#28 (comment))
For the last few months, myself and now several other contributors including @ripcurlx, @alexej996 and @mrosseel have been writing monthly report comments on our respective role issues.
Here are some examples:
I am proposing here that every primary role owner write a monthly report comment on the role(s) that they own (see #12 regarding the distinction between primary and secondary role owner).
The reasons for this are several:
These reports are a great way to share information with other contributors and with the Bisq community at large about the things you're responsible for. Anyone can click the "Subscribe" button on any role issue (or indeed can Watch the entire bisq-network/roles repository), and get regular updates about whichever roles they care about. This is a fundamentally scalable approach to information sharing.
These reports serve as a basic kind of "heartbeat" message from role owners, letting the network (of other contributors) know that they are in fact on top of their duties, or at least that they are not obviously derelict in their duties. If there is nothing to report on a given month, just say "Nothing to report". The important thing there is that you are reporting in the first place, and in doing so, letting folks know "all is well with this role" (and that you should indeed be compensated for performing the duties of that role).
Doing reports this way makes compensation requests easier to write and easier to evaluate. Where roles are involved, compensation requests should consist of nothing more than a set of links to monthly role updates. For an example of how this looks in practice, see my own compensation requests, e.g. Adding specification for the forum operator role roles#57 and Analytics Maintainer roles#40. This way, you can say as much or as little about your roles as you like in the monthly reports for each, and then simply link to that report comment from your compensation request. This makes it easier for stakeholders to evaluate compensation requests during voting as well, because they know that compensation requests are mostly "thin" documents consisting of links to more substantive reports that follow a common format. This way we don't have to parse every contributors different, idiomatic approach to writing compensation requests.
So, to re-iterate: I propose that every primary role owner start writing monthly report comments starting with the next round of compensation requests that we will vote on from May 1–3rd.
If we have a rough consensus on this proposal by that time, I will vote
0for any proposal that does not include monthly report comments in May, and I will vote-1for any proposal that does not include them in June and beyond.Also, I propose we continue with the format that has emerged for these comments, which is as follows:
Where the date obviously changes with each month, and the linked compensation issue is that role owner's current (draft) compensation request for the month. You can see the effect that this kind of round-trip referencing has between roles and compensation requests by looking at my request for this month at bisq-network/compensation#57.
I wanted to get this proposal together now, just as our May voting is finishing up, so everybody has plenty of time to consider it prior to the next voting round. Thanks, all.
(See also this month's Roles Maintainer role update, where I first suggested that we institutionalize this process of writing monthly updates: bisq-network/roles#28 (comment))