Bounty/Grant Submission AIP (AIP-005)

alperenag · October 27, 2024, 6:13pm

Hey everyone, I’ve created a draft for an AIP regulating bounty/grant submission, as well as directing a location on Discourse for the technical discussions regarding that bounty/grant. I’ve uploaded the AIP to Github, and am sharing the link below. We can discuss the details under this forum thread.

github.com

alperenag/dao-aips/blob/patch-1/AIPs/AIP-005.md

# Arrow Improvement Proposal: AIP-XXX

**Title**: Bounty/Grant Submission  
**AIP Number**: XXX  
**Authors**: alperenag  
**Status**: Draft  
**Type**: Standards  
**Created**: YYYY-MM-DD  

---

## Abstract

This AIP proposes a new, standardized process for all bounty and grant submissions within Arrow Air DAO to enhance transparency, organization, and accountability. The proposed process includes the mandatory use of an "Information Note" document, which will serve as a detailed and structured blueprint for each submission, outlining the project's objectives, deliverables, methodology, and results.

Additionally, the AIP introduces a structured folder system within the GitHub repository to systematically organize all submissions and associated deliverables according to their project and category, ensuring all documentation and outputs are easily accessible and well-maintained for future reference. This structured approach will improve the efficiency of locating, tracking, and reviewing past work, fostering a streamlined process for future iterations or improvements.

Furthermore, a Discourse forum will be integrated to provide a dedicated space for technical discussions and collaboration related to each bounty or grant. This forum will mirror the structure of the GitHub repository, allowing DAO members and contributors to engage in transparent, documented conversations and updates throughout the project’s lifecycle.

This file has been truncated. show original

I also think about some features that we can add to this AIP but I’m not sure, so please make your comments.

We talked about some bounty/grants that are relatively big so they will have milestones. We can add something to track the milestones in that document and ask the bounty/grant workers to update this document with each milestone. We’ll have the record of each milestone, and someone else come and pick up where it’s left if the bounty/grant worker stops continuing the bounty after a milestone for some reason. However, we cannot call it completed and I couldn’t decide how to label a half-completed bounty/grant in the bounty board.
We may add a document that’s listing all the completed bounties/grants in the main project repo. When completed, summary of each bounty/grant can be added to that document, along with the proper keywords. It may make things easily findable in case there’re hundreds of bounty/grants in that folder.
We can add a e-signature system on Github. The bounty/grant would be completed if it gets 3 out of 5 GBC member signatures. However, this can have bad outcomes such as GBC members approving a bounty/grant completion without knowing the details, so I believe each bounty/grant should be verbally approved in a GBC meeting. Even if we were to consider using an e-signature system, I would propose instead converting each bounty/grant into a smart contract. I believe this approach would be a worthwhile effort.

Please review the AIP draft and think about my ideas. Since we officially started developing Project Quiver and I would like to have all the bounty/grant submissions in the same format and proper location, I think we need to act fast on this one. We can discuss your ideas under this forum thread. Looking forward to seeing your feedback.

sleety · October 28, 2024, 2:57pm

Is this where the Information Note would live? Inside the Bounty/Grant Unique ID folder?

alperenag · October 29, 2024, 2:43am

Yes, this is what I have in my mind! I think one unique folder for each bounty will keep everything tidy, since all the deliverables will be there with the Information Note.

I’m not sure about the bounty/grant ID though, have we ever discussed something like that?

errrks.eth · October 31, 2024, 5:02pm

Thank you, Alperen.

I think this is a good AIP and will help us have clear guidelines for organizing all of the bounties and grants. A few points/questions:

Should we include a link to any templates mentioned?
For the sake of not having a huge dump of information on Discourse all at once, should we enforce a bi-weekly progress update on discourse? This could help the worker with documentation. Not sure if this is added work. I am just worried we’ll have someone working on something for a while and then try to cram all of their documentation at once?
How often will we expect the workers to make updates to their github? Will we just monitor that to get an idea of how they are progressing?

Regarding the additional features:

I don’t know of a good way to track milestone progress. I guess there can be an additional .MD file in the github repo that is detailing the progress. Seems like the easiest way to keep track. Maybe an inclusion to the AIP can be some kind of milestone tracking template?
I think showing that on the main repo is a good idea. We could also include a table of contents that just shows the bounty # and title.
Yeah I think for now that can work. In the future I think there is other ways to automate it but that might be outside the scope of this AIP?

alperenag · November 4, 2024, 1:21am

Should we include a link to any templates mentioned?

I thought it was easy to find the draft from the link, it’s my mistake. Agreed, link attached.

For the sake of not having a huge dump of information on Discourse all at once, should we enforce a bi-weekly progress update on discourse? This could help the worker with documentation. Not sure if this is added work. I am just worried we’ll have someone working on something for a while and then try to cram all of their documentation at once?

I don’t think there’ll be an information dump on Discourse since the formal submission will be on Github. The technical discussions will be on Discourse when needed. Let’s say the bounty/grant worker has two options for landing gear and he wants to get some ideas from the rest of the team. He’ll write it down on Discourse and the discussion will be logged there.

For the sake of popping up on search engines, we can also copy the final submission Information Note to regarding Discourse forum thread.

We can encourage the workers to post updates on Discourse about their progress but forcing it may be an extra work.

How often will we expect the workers to make updates to their github? Will we just monitor that to get an idea of how they are progressing?

I imagine Github submission as the final submission for the whole bounty/grant. When completed, the worker will post the Information Note and the deliverables on Github and request a review and approval. Everyone has different workstyles, I don’t want to force them to comply one working technique. At the same time, if the bounty is relatively big, it’ll have milestones, which will require submissions for the work done on before that milestone (also referring to my discussion #1 here). I believe it’ll keep things on track and won’t let them drift too much.

I don’t know of a good way to track milestone progress. I guess there can be an additional .MD file in the github repo that is detailing the progress. Seems like the easiest way to keep track. Maybe an inclusion to the AIP can be some kind of milestone tracking template?

Agreed, at the beginning of each information note there can be milestones section, in which you’ll list your milestones for that bounty. For each milestone submission, you’ll have to fill the chapter for your milestone and merge it to the rest of the doc. I can modify the template that way.

I think showing that on the main repo is a good idea. We could also include a table of contents that just shows the bounty # and title.

Agreed, makes perfect sense, it’ll be great if we do both actually.

Yeah I think for now that can work. In the future I think there is other ways to automate it but that might be outside the scope of this AIP?

Agreed, I just wanted to clarify if you guys want to integrate the e-signature feature on Github. The rest was just my opinions on the matter, as a future reference.

Thank you Erick for your feedback, those were really good points. Please let me know if you disagree on any of them!

thomasg · November 5, 2024, 9:08pm

I think the reference information note that you created provides a lot of clarity to this process and would make it easy for someone taking their first bounty to get it completed.

Is there a good place for this type of document to be stored in the AIPs repository @sleety?

sleety · November 7, 2024, 3:10pm

We could maybe create a new AIPs/templates repo. It could store our (currently loose) AIP template & AIP vote text template as well.

Maybe it would be better to allow people to just clone a project structure so they don’t misplace anything, and inside this project is the InformationNote.md template?

sleety · November 25, 2024, 8:33am

AIP needs an extra --- to format the table correctly (e.g. dao-aips/AIPs/AIP-004.md at patch-1 · alperenag/dao-aips · GitHub)
For the Discourse discussion part of the AIP, we should change the wording from “Create a new Discourse Thread” to “Create a new Discourse Topic”

Discourse Forum Integration
For each approved bounty or grant, a corresponding Discourse forum MUST be set up, mirroring the GitHub folder hierarchy for consistency.

How do think we can mirror the folder hierarchy in Discourse? Would we need to update our discourse categories to have a new category for each Project?

Each forum SHALL use proper tags for the bounty or grant.

So, using Discourse’s terminology - are you imagining this would look like:
Project Category

sleety · November 25, 2024, 9:25am

Information Note Requirement:

After submission, the Information Note SHALL NOT be modified, excluding the status section.

Would adding ‘Remarks’ to the document not contradict this? Do you mean "the Information Note SHALL NOT be modified by the applicant?

From the GBC’s perspective, what if the scope of the grant changes? Would they not be able to update the new deliverables? Would they have to append all these changes to the information note? Or would all this just go in “Remarks”

sleety · November 25, 2024, 9:33am

Structured Folder System:
All deliverables SHALL be located in the designated folder.

All pictures MUST be placed in a folder named “picture”, under the bounty or grant folder. This will help viewing other main deliverables easily.

I would prefer a separate /assets folder at the same level as /AIPs, with a new folder for each AIP e.g. /aip-5

Like the way EIPs are structured here:

Topic		Replies	Views
AIP-002 Discussion: Creation of Grants and Bounties Committee AIPs discussion	0	20	August 26, 2024
AIP-004 Discussion: Introduce Time Commitment Grant AIPs discussion	4	39	September 3, 2024
Bounty Proposal Template Grants / Bounties draft	1	18	October 7, 2024
AIP-001 Sentiment Poll - AIP Purpose & Guidelines AIPs sentiment-vote	9	68	September 2, 2024
AIP-002 Sentiment Poll - Creation of Grants and Bounties Committee AIPs sentiment-vote	0	27	August 26, 2024

Bounty/Grant Submission AIP (AIP-005)

Related topics