Dear Polkadot Community,
we are excited to share our proposal for retroactive funding of the <a href="https://graypaper.fluffylabs.dev/">Gray Paper Reader</a>, a tool that makes it easier to work with the Gray Paper for JAM. The Reader helps with sharing, annotating, and tracking changes in the document, solving challenges many teams face. It&rsquo;s open-source, already in use by the community, and hosted at graypaper.fluffylabs.dev. We hope for your support to continue improving this tool for everyone in the Polkadot ecosystem.
Full proposal text:&nbsp;<a href="https://docs.google.com/document/d/1i_tg_scBP5GrY_IM7eH4lpPZDrGbk5rGAi-Lf1s28cU">https://docs.google.com/document/d/1i_tg_scBP5GrY_IM7eH4lpPZDrGbk5rGAi-Lf1s28cU</a>
&nbsp;
General project information
Project Category / Type: Software development Proponent: FluffyLabs.dev USDC address: 15fGrDWmFoaApnZXEw1Zg45zuCqpkbMS9YPzczeU9dHseUUu Requested allocation: 21.000 USDC Income taxable: 19% tax on &ldquo;virtual currencies&rdquo; tax in Poland: <a href="https://www.podatki.gov.pl/en/your-e-pit/pit-38-for-2022/">https://www.podatki.gov.pl/en/your-e-pit/pit-38-for-2022/</a> Discussion date: Jan 19th 2025 Onchain publish date: planned for Feb 1st 2025 Previous treasury proposals: none for the GrayPaper (The team received <a href="../referenda/1340">retroactive funding for the PVM Debugger</a>)
&nbsp;
Context
The Gray Paper is the formal specification of JAM, the next generation of Polkadot Cloud. It&rsquo;s detailed but not easy to read, understand, and keep up with it, as it changes over time.
There are over 20 teams that publicly stated (including us), they are participating in the JAM Prize Contest and all their members surely do read the Gray Paper. Discussions in Element channels highlight the need to clarify some parts or fix errors, so the document changes over time. There are also at least 4 major revisions planned adding extra features.
We built the Gray Paper Reader to alleviate major pain points we identified.
&nbsp;
Problem
While working with the Gray Paper PDF versions internally, we identified the following issues and addressed them in the Gray Paper Reader. It&rsquo;s difficult to quickly share a fragment or formula from the PDF.
Screenshots are somewhat of an option, but they lack the bigger context and require indication from which version of the GP they are taken. Referencing GP from the code comments may quickly get outdated.
Both quoting a fragment or referencing a formula id may not be valid in the newer revision of GP.
Notes on both printed or digital versions are hard to transfer to a newer revision.
&nbsp;
Proposal
We propose retroactive funding for the development of the Gray Paper Reader hosted at <a href="https://graypaper.fluffylabs.dev">https://graypaper.fluffylabs.dev</a> with open source code using permissive license available on github (<a href="https://github.com/fluffylabs/graypaper-reader).">https://github.com/fluffylabs/graypaper-reader).</a> Unlike the JAM prize, which focuses on client implementations, no existing funding covers the creation of ecosystem tools like the Gray Paper Reader.
&nbsp;
Available solutions
There are tools like Adobe Acrobat, Mendeley, and Notion for working with PDFs. These tools include features like annotations, version history, and sharing, but they don&rsquo;t fully alleviate identified problems:
<ul>
<li>Adobe Acrobat: Great for comments and highlights, but doesn&rsquo;t help with tracking notes across versions or supporting Gray Paper discussions by sharing short links.</li>
<li>Mendeley: Good for research papers but not built for changing, evolving documents like the Gray Paper.</li>
<li>Notion: Useful for shared notes and organization but doesn&rsquo;t directly support detailed version tracking or work well with PDFs.</li>
</ul>
&nbsp;
Features
The Gray Paper Reader features:
<ul>
<li>Archive of published Gray Paper versions</li>
<li>Easily switching between multiple revisions of the Gray Paper.</li>
<li>Quickly switching the color scheme of the Gray Paper (Light, Dark and Gray modes).</li>
<li>Short Links to specific fragments of a specific revision for easy sharing on open discussion channels</li>
<li>Attaching notes with rich formatting to specific fragments and automatically migrating them between revisions.</li>
<li>A command line tool to scan codebase for links to the reader and automatically migrating them to newer revisions.</li>
<li>Backlinks to all messages sent on JAM Element Chat that included the link to the reader.</li>
<li>Automatic upgrade of the tool in case a new version of Gray Paper is released. Below is an outline of the deliverables and key functionalities.</li>
</ul>
The deliverable is open-source under the MIT license.
&nbsp;
Deliverables
<ul>
<li>Web application: <a href="https://graypaper.fluffylabs.dev">https://graypaper.fluffylabs.dev</a></li>
<li>Open Source Code: <a href="https://github.com/FluffyLabs/graypaper-reader">https://github.com/FluffyLabs/graypaper-reader</a> (MPL-2.0)</li>
<li>Links check tool: <a href="https://www.npmjs.com/package/@fluffylabs/links-check">https://www.npmjs.com/package/@fluffylabs/links-check</a></li>
<li>Matrix Bot: <a href="https://github.com/FluffyLabs/graypaper-reader/tree/main/tools/matrix-bot">https://github.com/FluffyLabs/graypaper-reader/tree/main/tools/matrix-bot</a></li>
</ul>
&nbsp;
Adoption
<img src="https://fluffylabs.dev/assets/images/reader_screenshot_2.png" alt="" width="700" height="373" />
<img src="https://fluffylabs.dev/assets/images/reade_screenshot_3.png" alt="" width="700" height="245" />
Links to Gray Paper Reader are already used extensively in the official Element Gray Paper room (<a href="https://app.element.io/#/room/#graypaper:polkadot.io)">https://app.element.io/#/room/#graypaper:polkadot.io)</a> as a common way to reference sections of the document. Over the period of 2.5 months (Mid-Oct to End-Dec) 21 unique users sent 136 messages that included a link to Gray Paper Reader. These conversations can be viewed as in-document annotations in the beta version of the tool available here (<a href="https://graypaper-reader.netlify.app/">link</a>).
&nbsp;
Timeline
This proposal seeks retroactive funding for the development of the Graypaper Reader, which began in early August 2024 and finished End of December with Release 1.0.
For detailed information and the features planned in the futures, please refer to the <a href="https://docs.google.com/document/d/1i_tg_scBP5GrY_IM7eH4lpPZDrGbk5rGAi-Lf1s28cU">Full Proposal Text</a>
&nbsp;
Budget
The Graypaper Reader development is complete, and we are seeking retroactive funding
Total budget: $21,000 (Detailed breakdown of the budget in the <a href="https://docs.google.com/document/d/1i_tg_scBP5GrY_IM7eH4lpPZDrGbk5rGAi-Lf1s28cU">Full Proposal Text)</a>
&nbsp;
Proponent
USDC Address:15fGrDWmFoaApnZXEw1Zg45zuCqpkbMS9YPzczeU9dHseUUu Requested Allocation: 21.000 USDC Governance Referenda Origin Call: Small spender
&nbsp;
Contact Information
Team Member: Piotr Zwolinski Email: <a href="mailto:piotr@fluffylabs.dev">piotr@fluffylabs.dev</a> Element: @piotrzwolinski:matrix.org
&nbsp;
Team
FluffyLabs develops JAM and supporting tools, including the PVM Debugger (with successful retroactive funding from the Treasury) and the GrayPaper reader.
For details on the development team, please refer to the <a href="https://docs.google.com/document/d/1i_tg_scBP5GrY_IM7eH4lpPZDrGbk5rGAi-Lf1s28cU">Full Proposal Text</a>

[Retroactive Funding] JAM GrayPaper Reader

Treasury

This proposal seeks retroactive funding for the development of the Gray Paper Reader, an open-source tool designed to enhance accessibility and usability of the JAM Gray Paper, Polkadot Cloud’s formal specification. 

Propose and approve a spend of treasury funds.

## Dispatch Origin

Must be [`Config::SpendOrigin`] with the `Success` value being at least
`amount` of `asset_kind` in the native asset. The amount of `asset_kind` is converted
for assertion using the [`Config::BalanceConverter`].

## Details

Create an approved spend for transferring a specific `amount` of `asset_kind` to a
designated beneficiary. The spend must be claimed using the `payout` dispatchable within
the [`Config::PayoutPeriod`].

### Parameters
- `asset_kind`: An indicator of the specific asset class to be spent.
- `amount`: The amount to be transferred from the treasury to the `beneficiary`.
- `beneficiary`: The beneficiary of the spend.
- `valid_from`: The block number from which the spend can be claimed. It can refer to
  the past if the resulting spend has not yet expired according to the
  [`Config::PayoutPeriod`]. If `None`, the spend can be claimed immediately after
  approval.

## Events

Emits [`Event::AssetSpendApproved`] if successful.

- **Problem Statement & Audience:** Difficulty in working with the Gray Paper for JAM, faced by teams in the Polkadot ecosystem.
- **Significance:** Over 20 teams in the JAM Prize Contest need to understand and track changes in the Gray Paper.
- **Proposed Solution:** Retroactive funding for the development of the Gray Paper Reader to address sharing, annotating, and tracking changes in the document.
- **Expected Outcomes:** Improved collaboration and understanding within the Polkadot community through an open-source tool with features like version tracking and easy sharing.

#1413 [Retroactive Funding] JAM GrayPaper Reader

No Active Proposals