Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
As , I can <what?> so that <why?>
As a collective owner, I can see the total amount of recurring donations so that my contributors and I can allocate our monthly budget.
Best solution for this problem
What does the ideal solution look like?
The current amount of recurring donations (after fees/deductions) is easy to find for collective owners.
What will be built as an MVP? (Please refer to our wiki for what's acceptable as an MVP.)
I think a logical place would be the "Estimated Annual Budget" display.
What metrics will be used to measure impact?
The goal of the documentation should be to make it easier for others to do this
No new documentation necessary. If there is documentation with images containing the "Estimated Annual Budget" meter, those will eventually need to be updated.
I think it's a little complicated at the moment so we'll need to figure out some things (otherwise it seems like the original idea is simply to divide the current number by 12 and display that)? Some thoughts:
I think the current calculations for an annual estimate amount sort of inflate what the the annual estimation is because it assumes any one-time donations will continue to happen in the future (just total up all contributions in the last year).
For our project maybe we would rather be conservative in the estimation and only include monthly donations (or if someone is actually donating year then you could divide it by 12). So it's not that they aren't meaningful but it seems less reliable to use those to make a decision on spending? This is more the case if you get a large one-time donation.
Maybe you could have the option? (depending on the project) to choose to only show the estimated monthly donations and basically ignore the one-time ones in that calculation? Even better you could show the change from the last month to the current month.
Maybe it's fine to show the total but it is more useful to know specifically the monthly amounts. So maybe something like (assuming the monthly was $1k) - will have to figure out wording
Could even do a range (lower bound via monthly, higher via total)
My proposal is to only show the sum of recurring monthly donations, minus fees and deductions. The total divided by 12 would not be useful for me.
For context, I split monthly donations between me and a co-maintainer. One-time donations are used for misc. expenses like merch and donating to upstream projects. So to determine the funds that go to me and my co-maintainer, I need to determine the recurring monthly revenue.
With the new collective page we're changing the way this information is displayed:
We've also added a tooltip where we could display more advanced information.
Based on what you both describe, I propose to keep the estimated annual budget view as it is today and to add the following breakdown in the tooltip:
@hzoo's suggestion to show the progress is also very good:
Ok great then we are probably on the same page then. Knowing the recurring (whether monthly or yearly which could be viewed as monthly) seems like the key as you can make decisions around that like in your case splitting it.
Yeah that could be good!
Would monthly also be calculated via the last month and same for year? Because those calculations wouldn't be the same as literally totaling all the funds in the last 12 months and I wonder how people will understand that.
In the interest of simplicity, maybe we could go with:
One thing I'm worried about is we need to design for different Collective types. Those participating in this thread so far represent Collectives where monthly recurring contributions are the main focus, but we also have Collectives funded mainly or only through large one-off contributions (e.g. grants), and we have to make sure they don't end up with misleading $0 figures showing prominently either.