Crates.io | collective |
lib.rs | collective |
version | 0.6.0 |
source | src |
created_at | 2024-02-18 18:36:21.489141 |
updated_at | 2024-06-21 19:26:55.637793 |
description | A CLI to automate work around Polkadot collective work reports. |
homepage | |
repository | https://github.com/ggwpez/fellowship |
max_upload_size | |
id | 1144311 |
size | 940,484 |
Provides a way to create evidence reports for Polkadot On-Chain collectives. Reports are machine readable and can be rendered. This is just a proposed format - it is not required to do it this way.
The rendered HTML/PDF output of a work-evidence can look like this:
Or a Request for Admission to a Collective:
The main part of this repository is the schema file. It provides a guideline to what information should be provided in a work report for a System Collective.
The most straight-forward way is to copy the template and fill it out manually. Thats it, no CLI needed! Although without editor support and validation it will be difficult.
If you want editor support and auto-complete for the fields, then you can download the schema file and configure it in your editor. Its explained for VsCode below.
There is a validate evidence
subcommand available to check that the evidence files conform to the schema.
Open your settings.json
file and insert the following, or extend this section. You need to replace the path with the path of the schema. This is just an example:
"yaml.schemas": {
"/Users/oliver/Documents/work/collective-cli/schema/potoc.evidence_report.json": "*.evidence",
},
"files.associations": {
"*.evidence": "yaml",
},
You can install the CLI like this:
cargo install --git https://github.com/super-collective/collective-cli
Running collective new evidence
will prompt you with a few basic questions. These will be stored in a config file and are available on the next run.
The CLI can convert .evidence
files into HTML. It is also possible to further convert the HTML files into PDF with:
# https://github.com/michaelrsweet/htmldoc
htmldoc --webpage -f example/example.pdf example/example.html
# https://github.com/ilaborie/html2pdf
html2pdf example/example.html
There is a new join-request
subcommand that you can use to create a request for admission. It is also possible to fill out the adapt the example file manually. Currently there is no schema for this, so the only way to validate it is with check join-request --files ..
.
This should create a file in the join_request/
directory of your collective. You can also render this into html with render join-request ..
.
GPL-3.0-only, see LICENSE.