owned this note
owned this note
Published
Linked with GitHub
# Proposer, PA, vPA Guidelines Tasks Set-up Doc
*Pre Fund 10, started 2022-10-04*
Fund 10 Improvements Task Force Mater page
https://hackmd.io/@PA-vPATreasury/S1H32eyNs
## Purpose
To describe problems with the current process for updating the proposer, proposal assessor and veteran proposal assessor guidelines.
To propose solutions to the problems identified in terms of
1. Document infrastructure
2. Communication channels
3. How tasks are created
4. Task assignment
5. Task completion rewards
## Task Guidance
*See Sub-Circle Working Group Process Doc (courtesy of QA-DAO): https://quality-assurance-dao.gitbook.io/community-governance-oversight/circle-problem-sensing/circle-problem-sensing/circle-oversight-working-group*
## Problem Statement Rubric
1. ### Identify (What Problem Do We See?)
The guides for proposers, proposal assessors and veteran proposal assessors have not yet been updated based on feedback from the community. The process of updating these documents is also not well-defined. There are many passionate and talented individuals with suggestions for improving the four core process documents (Proposer Guide, Challenge Team Guide, Proposal Assessor, and Veteran Proposer Assessor). These suggestions exist across a large collection of documents and conversations from editable Google Docs, to Telegram, to DeWork, and Discord among many other. There are also copies of current and former documents existing across many project catalyst sites such as IdeaScale, ProjectCatalyst.org, CardanoCataly.st. and others. This is decentralization at work!
2. ### Rank in Catalyst Context (Why is solving this problem important to the mission of Project Catalyst?)
Catalyst values collaborative ideation. The current process for altering these main documents makes collaboration too challenging for most people. Additionally, the documents are all edited separately from each other. This leads to confusion in the overall process of Catalyst where Proposers are being told to write proposals in one way, but PAs are being told assess something different, and vPAs are being asked to evaluate based on yet another set of criteria. Placing all these documents into a single system could lead to a more consistent set of criteria across the entire Catalyst process.
3. ### Solution Articulation (Describe the gap between the current state and the envisioned state?)
The goal is to develop an open source system for improving the core documents of the Project Catalyst roles (Proposer, Challenge Team, PA, and vPA). This process currently takes place in the comments and suggestions of a set of Google Documents. This process requires being able to find and edit the Google Documents. Google documents while being easy to use and collaborative are not open source. Nor do they easily have an open versioning system, or are they easy to clone, while tracking the various changes.
The prosposed solution would involve hackmd.io which pairs with a github repository that would be open source. Hackmd allows for collaborative editing of documents that can be pushed to a github repository. The github repositroy could manage document versioning, and allow for cloning and translating, while tracking changes through pull and push requests. It would also allow for individuals and community organizations to subscribe for change notifcations so that they can share the most current version on their own resource websites using tools like gitbooks.
4. ### Define Metrics (How might the value of solving this problem be quantified and/or measured?)
Measuring success of this project would entail looking at two metrics.
1. The number of participants in the editing process. If successful, this project would see the number of participants engaging in the document improvement process increase dramatically from fund to fund.
3. The number of pull requests from the documentation repository. If successful, this would mean that organization and indivudals are linking to the documents and taking advantage of the open source nature and ease of use of the repository model.
### Mission
* To collate and implement community suggestions for improving Proposer, PA, and vPA Guides
* To standardize the Project Catalyst Documentation (Proposer Guide, PA Guide, and VPA Guide) for Fund 10 across all info channels
* To provide consistent objectives for proposals across all three stages (Proposer, PA, and vPA)
### Goals
* Define tasks and deadlines of tasks that need to be done. (1 wk or less)
* Find tasks from TODO and Community
* Create them as subtasks in DeWork and in this/or a master Document
* Assign each task a priority
* Assign each task an estimated # of hours to completion
* Assign each task a due date/deadline
* Develop an open-source, community-owned documentation portal
## Working Group Notes
* 2022-10-04 9am MST 1st Working Group Meeting notes: https://hackmd.io/@jZcbjoPSQUmr5bdX0W33Sw/r1jg3pKfj
* Working group Strategy Document: https://docs.google.com/document/d/1tNtofXfwrEitMwWo_kv_VAm06lwKSMTX-33EcWSxGls/edit#
## Relevant Links to Current Task
* Dework task: https://app.dework.xyz/catalyst-circle-ca-r/community-input?taskId=cd125e9a-1792-46ee-8d34-56b9ae798710
* Github task: https://github.com/circle-ca-rep/shared-ideas/issues/7
## Current Community Suggestions to Improve Catalyst Documentation
* PA, VPA Guidelines TODO doc: https://docs.google.com/document/d/1H9hFwTM4AmErYa7bWyJlLGO2dnuZJ8H1KEk6KTBqaD0/edit#heading=h.70qyzqqlye91
* Project Catalyst Perceived issues with roles and change recommendations: https://cryptpad.fr/pad/#/2/pad/view/bwXHk29XYJH-a2fmtPOH87Sm0z2HpORkoBBYI8C8ZTQ/
* SUGGESTION: Classification of Excellent/Good/Filter-Out: https://docs.google.com/document/d/18WDxMB_UfyWSyll5bIOCbUvxeISp8_uAV4ANOdO1ZUU/edit#heading=h.vk7mv1hdviwx
* SUGGESTION: A 2-Stage Catalyst Process: https://docs.google.com/document/d/1lRB8OzAgp3nf-QJ1Xp29AodkX8ZPxyWCW0UU0SHEro8/edit#heading=h.pzput8rr24gj
* Everything wrong with Catalyst forum post: https://forum.cardano.org/t/everything-thats-wrong-with-catalyst/108482
* Proposal Grant Funding Advice from Cardano Community Hubs: https://cardanocommunityhubs.com/online-grant-funding-guide https://t.me/catalystproposers/8942
* Surfaced suggestions for improving Proposer, Assessor and Voting phases, created by Kenric based on his time as CA/vCA rep for CCv2: https://docs.google.com/document/d/1_hKY5HrU51WtlmlVhvLVps9oyhcU3dmw32JV9SFZU0g/edit
## Catalyst Issues submission locations:
* Fund 8 CA/VCA Sensed Issues: https://docs.google.com/document/d/1lwJI3pv8esPCSPRPc4b2HEnrSd9xnwU8B5kQooJ89Q4/edit#heading=h.kr7oxznl1c0n
* Community Suggestions from Fund7/8 on Dework: https://app.dework.xyz/catalyst-circle-ca-r/suggestions
* Iterative Dropbox: https://docs.google.com/spreadsheets/d/120HylsMq-2oXeop7m8vBoaf7eb2D8viJazJs_EPWU2I/edit#gid=0
* Ideascale Improvement Suggestions: https://cardano.ideascale.com/c/campaigns/25622/stage/all-stages/ideas/unspecified
* Catalyst Circle's Open Problems Page: https://github.com/Catalyst-Circle/Catalyst-Prioritized-Problems/issues
## Fund 9 Source Documents
* FUND 9 Official Proposer Assessor Guide: https://docs.google.com/document/d/1g-iZhDlKhUBZkui1uv8NVNfJC4oVD3JtR-P6Fue7XPU/edit
* FUND 9 Official Veteran Proposer Assessor Guide: https://docs.google.com/document/d/1eSX455MCilIe247xRVi51UZLGfKGPBrxJthvtV5sASg/edit
* Challenge and Proposal Guide - Fund 9: https://docs.google.com/document/d/1oE_cnP0gksdAanXV4w5DYaDNp_tbYEvyHhTUG4HYZ3Q/edit#heading=h.yyzko62ylks
* Ideascale Proposal Form Guidance Notes:
https://catalyst-circle.gitbook.io/funded-proposers-hub/help-with-proposing-in-catalyst/ideascale-proposal-form-guidance-notes-multi-lingual
* proposers' guide to flagging:
https://catalyst-circle.gitbook.io/funded-proposers-hub/help-with-proposing-in-catalyst/a-proposers-guide-to-assessment-flagging-multi-lingual
* vPA Petition Guide:
https://docs.google.com/document/d/1Dy95VisT_yx6FoafHrrwV6jnzWHpTeN21dkGNnSvn_Q/edit?usp=sharing
## Prior Source Documentation:
* Fund 7 Iterative Dropbox Documentation: https://docs.google.com/spreadsheets/d/120HylsMq-2oXeop7m8vBoaf7eb2D8viJazJs_EPWU2I/edit#gid=0
## Governance and Other Documentation
* Governance and Treasury Guidelines: https://docs.google.com/document/d/1bRFsYYbDc52U610XGgg2h-dBFdn2MhgvlXwHtElq3_0/edit
* VPA -WG Guidelines: https://pa-vpa-operations-treasury.gitbook.io/vpa-process-working-group/
* Cardano Catalyst Site with outdated info: https://www.cardanocatalyst.io/
* Project catalyst FAQ: (out of date) https://docs.google.com/document/d/1qYtV15WXeM_AQYvISzr0a0Qj2IzW3hDvhMBvZZ4w2jE/edit#
* Catalyst School: (seems to be out of date) https://catalyst-swarm.gitbook.io/the-catalyst-school/
* Insight sharing guideline (out of date): https://docs.google.com/document/d/1bSZaeICuyVnpvbgJDB4elENUF9Pv7MGrPTdmjOMPSEo/edit#