Current Behavior

https://cadence-lang.org/learn "Read the documentation" links to https://developers.flow.com/cadence/language

Expected Behavior

Link should link to https://cadence-lang.org/docs

Steps To Reproduce

See above

Environment

- OS:
- Node:
- npm:

What are you currently working on that this is blocking?

No response

Issue to be solved

One pattern that is very common is to give an capability to somebody. With the introduction of inbox/capcons i feel that shis should be elaborated a bit more.

Suggest A Solution

I created a PoC repo here https://github.com/bjartek/stable-cadence/tree/give-admin

What are you currently working on that this is blocking?

Just trying to help make flow ✨

Issue to be solved

it's not exactly clear according to the documentation what UInt and Int's precisions are.The current doc only mentions that it's an arbitrary size. Doing some digging it seems like the underlying implementation is a big.Int in Go with an initializer that bounds it to int64. This is particularly troublesome when someone needs to sync a piece of on-chain struct/event field into their database while not knowing the precision.

Suggest A Solution

improve documentation so that it's clear to developers what the max value of Int/UInt is. I understand the "arbitrary" argument in the context of Go, but can't wrap my head around this idea in a blockchain where everything is highly deterministic.

What are you currently working on that this is blocking?

No response

Issue to be solved

1. Website should have a top nav "Guide for Solidity Developers" linking to this item https://developers.flow.com/cadence/solidity-to-cadence

2. Documentation should link to this blog post https://flow.com/post/implementing-the-bored-ape-yacht-club-smart-

Suggest A Solution

No response

What are you currently working on that this is blocking?

No response

Issue to be solved

The Contract Updatability page does not currently document the rules for updating events.

For example, it is allowed to remove events.

Suggest A Solution

Document rules

What are you currently working on that this is blocking?

No response

Issue to be solved

The website should explain how to learn Cadence.

Suggest A Solution

• Add a new /learn page, and link to it in the top navigation bar and through the "Get started" CTA
• On the page:
  • Move videos from landing page
  • Link to the tutorials
  • Link to Playground
  • Link to documentation
  • Link to course: https://academy.ecdao.org/en
  • Link to Implementing the Bored Ape Yacht Club smart contract in Cadence

What are you currently working on that this is blocking?

No response

Issue to be solved

Suggested Solution

No response

Issue to be solved

This page refers to a version of a contract that is not updated to 1.0 https://cadence-lang.org/docs/1.0/design-patterns#solution-3

Suggest A Solution

No response

What are you currently working on that this is blocking?

No response

Issue to be solved

The website should describe how Cadence cares about security.

Suggest A Solution

• Add a new /security page and link to it in the top navigation bar
• On the page:
  • Explain how Cadence provides security for contracts
  • Explain how the Cadence implementation itself is secured
• Encourage responsible security reports (link to responsible disclosure page)
• Link to the past security announcements in the forum

What are you currently working on that this is blocking?

No response

Issue to be solved

The website should describe how Cadence is a community project.

Suggest A Solution

• Add a new /community page and link to it in the top navigation bar
• On the page:
  • Explain how Cadence is a community-driven project
  • Mention ways of how developers/users can contribute
    • Link feature request template on GitHub
    • Link to FLIPs, explain how giving feedback on FLIPs is useful, explain how, how to write a new FLIP, etc
    • Explain repos (cadence, cadence-tools)
    • Link to GitHub issues marked as "good first issue" in Cadence repos

Text:

Welcome to the Cadence community!

Together, we are working to build a programming language to empower everyone to push the boundaries of smart contracts and on-chain logic. 

What are you currently working on that this is blocking?

No response

use the same approach as https://github.com/onflow/docs
typesense

Current Behavior

When you click on the Edit this page link on any section it takes you to an empty url.

Expected Behavior

URLs should include /blob/main

Steps To Reproduce

Click the link

Environment

Doesn't matter

What are you currently working on that this is blocking?

No response

Issue to be solved

This section https://cadence-lang.org/docs/1.0/design-patterns#capability-revocation mentions capability revocation but it does not have a concrete examples. These scenarios are often hard for newcommers to grasp.

Suggest A Solution

Create an example of how to grant a ExampleNFT minter resource to another account that can be revoked. The same example can also be used in order to showcase how to permaently give a minter to another account, event though it can be argued that doing so is not really wise.

What are you currently working on that this is blocking?

Reviewing cadence docs page

Issue to be solved

We should update the Cadence 1.0 CLI installation command to reflect the latest changes in the forum post https://forum.flow.com/t/update-on-cadence-1-0/5197/10.

Suggest A Solution

Update the doc. We may need to create a new video.

What are you currently working on that this is blocking?

No response

Issue to be solved

https://cadence-lang.org/ does not have a web page icon that shows:

• on search engine results (for instance on google)
• on browser tabs

This gives the impression that the web page is not official or well maintained

Suggest A Solution

Use the new Cadence icon as the site icon

What are you currently working on that this is blocking?

No response

Issue to be solved

Review cadence docs

Language Reference

Tutorial

The bigger picture

These things might be strange about flow to others but it is not mentioned

• transactions and scripts are programs
• they compose
• an account can have multiple contracts
• an account can have multiple keys
• a key can be in multiple accounts

https://cadence-lang.org/docs/1.0/solidity-to-cadence#access-control-using-capabilities
cadence 1.0 docs still contain PublicAccount, AuthAccount, and private change them to &Account, auth(<Entitlement>) &Account, and access(self)

Current Behavior

• select 1.0 as version in docs
• search for "exists"
• click all results (the fact that i have to scroll down to find this link is not good)
• the search results shown are for 0.42 not 1.0

Expected Behavior

• the search results shown are for 1.0

Steps To Reproduce

• select 1.0 as version in docs
• search for "exists"
• click all results (the fact that i have to scroll down to find this link is not good)
• the search results shown are for 0.42 not 1.0

Environment

this is not relevant for this bugreport

What are you currently working on that this is blocking?

Stable cadence

Current Behavior

Going to https://cadence-lang.org/docs/1.0 shows

This is documentation for Cadence 1.0, which is no longer actively maintained.

For up-to-date documentation, see the latest version (0.42).

Expected Behavior

1.0 should be considered the upcoming version, and 0.42 should be the released version.

Steps To Reproduce

See above

Environment

Any

What are you currently working on that this is blocking?

No response

Issue to be solved

There is currently no way to go / link to the current documentation without knowing the version number.

For example, the current documentation is at https://cadence-lang.org/docs/0.42, but that will change in the future

Suggest A Solution

Add a route for https://cadence-lang.org/docs, which redirects to the current documentation, e.g. https://cadence-lang.org/docs/0.42.

This redirect should also work for sub-pages.

This feature exists on developers.flow.com. For example, https://developers.flow.com/cadence/language/syntax is the documentation for the Syntax of Cadence in the current version.

What are you currently working on that this is blocking?

No response

Issue to be solved

It seems to be a Test.getAccount(_ address: Address): Test.Account function according to the flow-code-coverage repo and the language interpreter that it is not documented.

Suggest A Solution

No response

What are you currently working on that this is blocking?

No response