Open-source Catalyst projects on GitHub don’t have easy access to documentation and open source tooling that can assist in milestone reporting, contributor resource allocation and project management.
We will develop procedural documentation & open source tooling that works with the GitHub API to create a user interface that assists in milestone reporting, resource allocation & project management.
This is the total amount allocated to Open Source Automation.
Stephen Whitenstall, Treasury Guild
No dependencies
Project will be fully open source
n/a
How we perceive the problem
There are barriers to entry in efficiently managing open source projects. This includes a lack of use of open source tools that are needed to assist in milestone reporting, contributor resource allocation and project management. This lack of tools inhibits Open Source project development and growth.
Our solution
The Fund 10 Open Source Automation proposal will address this problem by developing Open Source tooling including GitHub automation, a user interface and procedural documentation and guidance.
This will include -
1 - The specification, development and implementation of an automation solution on GitHub.
The first part of the project will set up and develop API calls needed to access GitHub issues and data from a project board. This will include the installation of a JavaScript framework, writing the code for API calls, and processing the returned data.
2 - A user Interface / dashboard
The second part of the project will build a user interface in the form of a dashboard that will present the processed data collected from the API calls. This will provide insight on a project’s monthly performance and assist with resource allocation. In addition a prompt generator will be provided that can be fed into chatGPT to generate a report on milestones.
3 - Procedural documentation and guidance.
The final part of the project will provide documentation and guidance on how the tool can be forked, so that it can be implemented by other users. This implementation will be made quite simple. To supplement the tool, documentary guidance will be provided on the use of GitHub project boards and issue tracking.
4 - A flexible code template.
The code is a template that can be tweaked to fit the way your project operates. Collaboration will be made easier as resource allocation will be more straightforward. A clear view of status and progression will help with project management and provide contributors with relevant information.
Reasons for our approach
Automation of routine tasks in open source projects enhances their functionality and broadens their utility to a wider audience. We intend to target the overhead of project management tasks familiar to many Catalyst proposers and build tools to assist with milestone management and reporting. In addition our dashboard will assist with user accessibility and our documentation will advise on developer reuse.
Who we will engage
We will engage, support and provide resources to existing and new project teams and share our work widely with the community. Our focus will be on helping Open Source users in Catalyst with their projects. For example this project management solution will be used by the SingularityNet Archive workgroup, QADAO, Treasury Guild and Community Governance Oversight.
How we will demonstrate or prove our impact
We will demonstrate and prove the impact of our proposal by tracking the use of this resource, incorporating feedback and documenting lessons learnt on our GitHub project board.
This proposal addresses the F10: Developer Ecosystem - The Evolution Challenge by equipping and supporting users and developers with tools and working infrastructure to further evolve the developer ecosystem. We are creating a tool that will directly support Catalyst proposers and incentivise the use of open source.
In particular we will fulfill the following Challenge directions -
We will bring the following benefits to the Cardano Ecosystem during and after the project completes
[Description] - We will effectively manage and measure the milestones of our project and our partner projects.
[Measurement] - By extracting data from the project boards and assessing how the tool is used we will demonstrate the impact on the productivity of our partner projects building on Cardano's ecosystem.
[Description] - In the short term, funded projects will do better reporting, this will benefit the Cardano ecosystem by promoting better monthly reports and successful projects.
[Measurement] - This will be measured by the number of reports created with the help of this tool.
[Description] - In the long term the use of our community created tools will improve the effective delivery, growth and productivity of projects building on the Cardano ecosystem.
[Measurement] - This will be measured by how many projects use our tool and how this use has impacted their productivity.
[Description] - Projects will have an easier time allocating resources to their contributors. This will benefit the Cardano ecosystem by promoting collaboration.
[Measurement] - This will be measured by the number of successful resource allocations done using this tool.
[Description] - The wider success of our project will be measured by the performance and number of projects forking our repo and using this tool.
[Measurement] - This will be measured by the number of times the repo has been forked.
[Description] - This project will be completely transparent by having a public GitHub Project Board that has all the information on tasks being done and ADA being allocated to the tasks. This will benefit the Cardano ecosystem by promoting transparency for funded projects in Catalyst.
[Measurement] - This will be measured by the number of tasks being completed on the project board and the commits made in the repo every month.
[Description] - When the tool is ready, people will have access to project dashboards and useful monthly performance stats. This will give people insight on the monthly performance and growth of tne project using this tool. This can be a great tool to view the performance of a funded project in Catalyst building on Cardano.
[Measurement] - The number of people who access our project dashboards and use the performance stats.
We plan to spread our project's outputs over discrete stages that run for 8 months. The detail of our milestones can be referenced in the Milestones section.
We will share our outputs with the aforementioned project teams (SingularityNet Archive Workgroup, QADAO, Treasury Guild and Community Governance Oversight) who can take advantage of efficiency opportunities.
We will share these dashboards with people we work with. (For example if we are in a call and someone shows interest in one of our projects, we can share this dashboard to show the progress of the project)
A successful completion of this proposal will support further research and development in streamlining project management of other community proposals. We expect to continue to develop further tools and enhancements that build upon this proposal.
Any future projects that we will work on will make use of this tool and hopefully other people in these other groups using the tool will also start using the tool in any other projects they are involved with. We will gather any feedback from them as well as look for improvements that can be made as we use this tool in the different projects.
Our capability is spread between our lead developer, our project manager and treasury guild support.
Our team (outlined in the [RESOURCES & VALUE FOR MONEY] section below) has already delivered a treasury platform, has implemented several proposals successfully and worked in collaboration with a broad range of community projects. Our experience in managing projects and project payouts as well as building the tools for these tasks/projects has been our main focus for the last 2 years in Catalyst and other ecosystems.
Part of our team is a Treasury Guild with extensive experience in fund management, and disbursement. They are trusted with the management of funds for several projects, including the ones that will use these tools. Our project boards will feature the ADA amounts to be paid out for specific tasks.
The main goals for this project are
1) To enable the development of API calls to GitHub to facilitate project management and reporting.
2) Achieve this through a staged development process that encompasses environment setup, development, deployment, data extraction and analysis.
3) Develop, test and implement a User Interface.
4) Ease reporting of milestones. We will focus on making it easier for our partner projects to manage and report on their milestones.
5) Thoroughly document the whole process.
6) Improve the efficiency of resource allocation for our partner projects.
7) Increase the productivity of our partner projects.
Milestone 1 - Preliminary work
Main task & Key Activities - Preliminary work. Planning, Administrative setup and purchase of software
Success or acceptance criteria - a successful setup
Proposed cost - 7200 ADA
Expected timeline - October 2023
Milestone 2 - Set-up infrastructure
Main task & Key Activities - Create repo, install framework, create GitHub API calls and deploy using Netlify
Success or acceptance criteria - Infrastructure setup, deployment and creation of API calls
Proposed cost - 12400 ADA
Expected timeline - November 2023
Milestone 3 - Process data
Main task & Key Activities - Process and structure GitHub issues and project board data
Success or acceptance criteria - Demonstration of availability of data
Proposed cost - 12400 ADA
Expected timeline - January 2024
Milestone 4 - User Interface Development
Main task & Key Activities - Design and build UI
Success or acceptance criteria - Demonstration of the UI
Proposed cost - 12400 ADA
Expected timeline - February 2024
Milestone 5 - Testing
Main task & Key Activities - Test performance and function. Make improvements
Success or acceptance criteria - Successful test case or reports
Proposed cost - 12400 ADA
Expected timeline - March 2024
Milestone 6 - Documentation
Main task & Key Activities - Create documentation on how to use this tool for your project
Success or acceptance criteria - Completed documentation
Proposed cost - 12000 ADA
Expected timeline - April 2024
Milestone 7 - Close Out
Main task & Key Activities - Write close out report
Success or acceptance criteria - The Close Out Report
Expected timeline - May 2024
The result of this proposal's work will be a tool that captures and processes the data from your GitHub project board and issues. This tool will provide the user with information that can assist with payouts, monthly reporting and an overview of the project’s performance and status.
We will measure the milestones listed below on the dates specified. This will be measured using GitHub commits and we will make use of a project board and issues to track the progress. We will even use the tool itself to track progress closer to the end of the project.
In total we will deliver 7 milestones (including the close out report). These breakdown as follows -
Milestone 1 - Preliminary work - October 2023 - 7200 ADA
Milestone 2 - Set-up infrastructure - November 2023 - 12400 ADA
Milestone 3 - Process data - January 2024- 12400 ADA
Milestone 4 - User Interface Development - February 2024 - 12400 ADA
Milestone 5 - Testing - March 2024 - 12400 ADA
Milestone 6 - Documentation - April 2024 - 12000 ADA
Milestone 7 - Close Out - May 2024
-------------------------------------------------
Fixed Costs
Software Licenses & Services - 3200 ADA
-------------------------------------------------
Human Resources
Development
-------------------------------------------------
Development Sub Total - 38800 ADA
Project Management
-------------------------------------------------
Treasury
-------------------------------------------------
-------------------------------------------------
Total - 68800 ADA
These are self-employed rates that take into account the employment overheads of the resources contracted. The rates are based on the low end of US and European averages. The amounts are calculated for each milestone based on the hours to complete.
The average JavaScript developer hourly rate is $50/hr. In addition this tool needs to accommodate different kinds of projects, so the design process for each step needs to take that into consideration. [Source - JavaScript Developer Hourly Rate Guide | Flexiple]
A freelance Accountant can charge from $50/hr. Treasury Guild is charging $50/hr for wallet setup, admin and payments. [Source - Accountant Hourly Rates | Crowdsourced List (contractrates.fyi)]
A freelance project manager can charge from $50/hr. In addition management of this project requires knowledge of open source software tools and an awareness of blockchain technology. [Source - Project Management Fees | Hourly & Consulting Rates | Salaries – OCM Solution]
In addition all the resources working on this project are taking on the currency risk of being paid in ADA. This means that a fall in the ADA price will result in being paid less or delivering less in each milestone. Any rise in the ADA price will represent a reward for investing in the Cardano ecosystem.
Consequently, given these factors, we believe this proposal offers excellent value for money in a volatile cryptocurrency environment
Andre Diamond has experience in Javascript frontend web development, GitHub automation and Database management. In November 2021, he joined the Catalyst Circle Admin team as Treasurer and later co-founded the Treasury Guild with Miroslav, Felix, and Tevo to amplify support for projects in the Catalyst community. Andre has also worked alongside Stephen to provide Automation tools to projects operating in Catalyst. Currently responsible for development on the Treasury Guild treasury dApp and other tools in the ecosystem.
Miro has 20 years of experience in managing finances. He also worked as a Human Resources Manager (HRM). Currently he is managing transactions for Swarm, Singularity Net, Governance Guild, Catalyst Training and Automation, Community Governance Oversight, Lead Generators, Edify.
Stephen Whitenstall is the co-founder of Quality-Assurance DAO, https://qadao.io/ , and has provided project management consultancy for many Catalyst projects since Fund 4 including Catalyst Circle, Audit Circle, Community Governance Oversight, Training & Automation (with Treasury Guild), Governance Guild and Swarm. A Circle V2 representative for funded proposers. Also engaged in cross chain collaboration with SingularityNET managing an Archive project. He has 30 years experience in development, test management, project management, social enterprises in Investment Banking, Telecoms and Local Government. A philosophy honors graduate with an interest in Blockchain governance.