GOR — Write Tutorials & Documentation

[moul]

Note: this issue will be updated to keep track of changes in rules.

Challenge Description

We are working to make Gnolang one of the easiest ways to write secure dApps in the future. But with today's state, only the most experienced developers can get started autonomously.

We need experienced devs to write or record tutorials to help more people get started during phase two of the competition (and beyond) and to help grow the Gno.land developer community.

What we look for in the submissions/suggestions on what could work for addressing the challenge

These tutorials can include topics like interacting with the chain from the CLI, step-by-step guides to creating smart contracts in Gno, tips for running a local dev environment, fast prototyping with gnodev, or they can be tutorials dedicated to certain audiences, such as developers coming from Solidity or web2.

All tutorials should be referenced on the awesome-gno GitHub repo.

What wins points

1. Idiomatic / well integrated — i.e, with go comments and generated outputs
2. High learning efficiency — the delta between before’s knowledge and after’s knowledge
3. Great UX — well-written, interactive, video, graphical
4. Text quality and clarity

---

Suggestions and examples (non-exhaustive):

• Tips & Snippets -- https://github.com/gnolang/awesome-gno#tips--snippets ([META] Tasks for non-programmers #540)
• TDD & Fast smart-contract development with gnodev
• Install a local testnet -> official issue: [docs] install local testnet / test contracts locally #478
• ERC20 vs GRC20, a comparison of a well-known application; should also give examples of composability
• Getting started template repo
• Good practices & Design patterns
• Porting existing contracts, applications, libraries to Gno
• Getting started challenges to quickly discover advanced concepts
• Gno concepts (Proposal: extend markdown rendering #439 (comment))
• Improve existing docs/links organization (Official "Getting Started" guide #499)

[moul]

Suggestions and examples (non-exhaustive):

• TDD & Fast smart-contract development with gnodev
• Install a local testnet -> official issue: [docs] install local testnet / test contracts locally #478
• ERC20 vs GRC20, a comparison of a well-known application; should also give examples of composability
• Getting started template repo
• Good practices & Design patterns
• Porting existing contracts, applications, libraries to Gno
• Getting started challenges to quickly discover advanced concepts

-> updated in the main issue body

[dongwon8247]

Made a PR to awesome-gno (gnoverse/awesome-gno#21), but sharing it here too.

Links for tutorial docs:

• Github: https://github.com/onbloc/gnoland-tutorials
• Gitbook: https://onbloc.gitbook.io/gnoland-developer-portal/
  (The Github and Gitbook are synced)

Any feedback & suggestions for improvement is welcomed!

[moul]

We'd like to experiment with a quick&fast way to make small contributions on this topic: Tips & Snippets.

It could make sense to isolate those quick tips & snippets in a CSV file used to generate an HTML page with previews.

-> gnoverse/awesome-gno#22

[moul]

There is a task going on here that only requires web dev skills and no need for being good at writing tutorials.

See:

• Official "Getting Started" guide #499
• Better rendering of awesome-gno gnoverse/awesome-gno#24

[marriedjven]

Hi, do you think this thread will be eligible for GOR or not?
https://bitcoingarden.org/forum/index.php?topic=122418.0