DOCUMENTATION REPOSITORY¶
This repository serves as a comprehensive resource for Zero-Knowledge Proofs (ZKPs), covering theoretical aspects, terminology, academic papers, and articles related to the subject.
How To Use This Repository¶
Prerequisite¶
Obsidian: While any markdown editor should be able to view/edit this repository, we recommend using this app since predefined settings are included in the repo to simplify your experience.
Common Guidelines¶
To maintain consistency in our repo content, please adhere to this checklist:
- File names should be written in snake_case format.
- Folder names should be written in dash-case format.
- Every markdown file must have a header.
- Every article should have its attributes defined.
- Any media files (images, PDFs, etc.) should be placed under the
attachments
folder in the current editing file. - Ensure every article has at least the same number of headers as in the corresponding PDF file.
Level¶
Each article will have a level
attribute with the value ranging from 1 to 10, where 1 means easiest to read and 10
means hardest to read.
Repository Structure¶
-
terms: This directory provides an introduction to basic terminology essential for understanding ZKP concepts.
-
articles: Explore this directory for PDFs of academic papers and articles related to ZKPs. Additionally, find details, comments, and reading status notes to aid comprehension.
-
docs: This directory contains definitions, explanations, and documentation pertaining to various types of ZKPs and specific ZKP technologies.
-
english: Don’t know how to pronounce math formulas? View this folder.
-
presentations: This directory contains all our presentation slides.
-
anki: This directory contains flashcards used to memorize ZKP-related contents.
How to create/sync Flashcards with Anki¶
- Follow the instruction written in here to connect with Anki.
- Mark a header as flashcard by adding a hidden link
[]()
at the end of the header. - Run
Flashcard: Generate for the current file
.
Markdown Linter¶
We use markdownlint to ensure consistency in our markdown files. Please install the linter and run it before submitting a PR. You can find the configuration file in the root directory of this repository.
To install the linter, run the following command:
npm install -g markdownlint-cli
If you want to run it manually, you can use the following command:
markdownlint '**/*.md' --fix
If you want to make the linter run automatically when you commit your changes:
cp pre-commit .git/hooks/
This structured organization aims to facilitate ease of navigation and comprehension for individuals seeking information on Zero-Knowledge Proofs. Regular updates and contributions to expand the repository’s content are highly encouraged through the standard Pull Request (PR) process. Thank you for your commitment to building a valuable resource on ZKP.