Skip to content

change contract updatability doc#776

Open
Anastasiya737 wants to merge 1 commit intomainfrom
feat/contract-updatability
Open

change contract updatability doc#776
Anastasiya737 wants to merge 1 commit intomainfrom
feat/contract-updatability

Conversation

@Anastasiya737
Copy link
Copy Markdown

contract updatability doc

@Anastasiya737 Anastasiya737 requested review from a team as code owners March 30, 2026 21:58
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 30, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
midnight-wiki Ready Ready Preview, Comment Mar 30, 2026 9:59pm

Request Review

@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


Stacy seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

@github-actions
Copy link
Copy Markdown

Summary

Status Count
🔍 Total 4
✅ Successful 1
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 1
❓ Unknown 0
🚫 Errors 2
⛔ Unsupported 0

Errors per input

Errors in docs/guides/contract-updatability.mdx

  • [ERROR] file:///home/runner/work/midnight-docs/midnight-docs/docs/guides/deploy-mn-app | Cannot find file
  • [ERROR] file:///home/runner/work/midnight-docs/midnight-docs/docs/relnotes/support-matrix | Cannot find file
    Full Github Actions output

@github-actions
Copy link
Copy Markdown

🚀 Preview Deployment

Deployment Ready

🔗 Preview URL: https://pr-776-midnight-docs.vercel.app

📝 Latest commit: af71256
Updated: Mar 30, 2026, 10:04 PM UTC


This preview updates automatically when you push new commits to this PR.

@nstanford5
Copy link
Copy Markdown
Contributor

Really great content complete with industry comparisons, code example and best practices for security concerns. I'm approving for accuracy of the content and assigning @gyrationtechs to review for technical writing style to match docs best practices.

Thank you @Anastasiya737

@nstanford5 nstanford5 requested a review from gyrationtechs April 2, 2026 18:10
Copy link
Copy Markdown
Contributor

@gyrationtechs gyrationtechs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Anastasiya737 Thank you for this. Detailed and easy to follow along.

A few minor suggestions. Then g2g!

sidebar_position: 40
---

# Making Decision on Contract Updatability
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The H1 title should ideally match the doc title. Let's also update it to use sentence case for the heading.

This guide explains how contract updatability is enabled in the Midnight network and why every DApp
developer has to understand its importance for uninterruptible and long-term contract operation.

## Importance of the Updatability Feature
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use sentence case for headings.

evolving proof generation and verification rules. A contract may become unusable because its proofs
can no longer be generated or verified.

To address this, Midnight provides contract updatability via a ContractMaintenanceAuthority that can
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is ContractMaintenanceAuthority a single word or needs to be separated?

Track proof system changes via [release compatibility matrix](../relnotes/support-matrix) and plan
circuit updates in advance whenever an upcoming release affects your contracts.

## How Updatability Works
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sentence case for headings


Operating a maintenance authority requires:

- Configuring the CMA during contract deployment (a set of the committee public keys and a signature
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use periods for each list item for consistency.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants