Add new article on overview Djed ReserveCoins,

[john-walter-munene]

This commit:

• Adds a new article: "An Overview of Djed ReserveCoins: Benefits, Risks and More."
• Adds images in support of this article

Summary by CodeRabbit

• Documentation
  • Added comprehensive article covering Djed ReserveCoins fundamentals, including reserve mechanisms, minting and redemption processes, fee structures, risk factors, and illustrative numerical examples.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Warning

Rate limit exceeded

@john-walter-munene has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 7 minutes and 8 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 6c271b0 and 11a9c69.

📒 Files selected for processing (1)

• public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md

📝 Walkthrough

Walkthrough

A new educational article is added documenting Djed ReserveCoins, covering reserve mechanisms, coin backing, minting/redemption mechanics, leverage concepts, and associated risks including oracle and redemption friction factors.

Changes

Cohort / File(s)	Summary
Documentation public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md	New article (+141 lines) introducing Djed ReserveCoins with sections on reserve surplus, base coin backing, minting/redemption mechanics, redeemable value calculations, benefits, risks (leverage, oracle risks, redemption friction), numerical examples, and references to Djed documentation.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

• Zahnentferner

Poem

🐰 A doc so fine, in markdown dressed,
On Djed ReserveCoins, our knowledge blessed!
With numbers clear and risks laid bare,
Our rabbit scribe shows utmost care! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Add new article on overview Djed ReserveCoins' directly aligns with the main change, which is adding a new article about Djed ReserveCoins.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🤖 Fix all issues with AI agents

In @public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md:
- Line 26: The image markdown reference
"![](../images/reserve-surplus-reserve-coins.webp)" is missing alt text; update
that image tag in the article to include a brief descriptive alt string (e.g.,
"Reserve, surplus, and reserve coins diagram" or another accurate description)
by replacing the empty brackets with the chosen text so the tag becomes ![your
description](../images/reserve-surplus-reserve-coins.webp).
- Around line 116-124: In the "Redemption Friction when Reserve Ratio is Low"
section, fix the typo "reversecoins" to "reservecoins" (the incorrect word
appears in the sentence starting "When this happens, a reservecoin holder
wishing to dispose of reversecoins..."); update that single word to the correct
term "reservecoins" so terminology is consistent with the rest of the article.

🧹 Nitpick comments (2)

public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md (2)

56-88: Leverage explanation is clear, but consider tightening wording at line 72.

The benefits section is well-explained with solid mathematical examples. At line 72, consider replacing "with respect to" with a more concise alternative like "relative to" or "over" for brevity.

✏️ Proposed wording improvement

-Reservecoins have a built-in leverage effect with respect to the underlying base coins.
+Reservecoins have a built-in leverage effect relative to the underlying base coins.

---

129-141: Final remarks section is strong; minor style refinements available.

The conclusion effectively summarizes the dual nature of benefits and risks. Consider these optional style improvements at line 131: (1) reorder "to clearly describe" as "to describe clearly" (avoiding split infinitive), and (2) replace "drop" with "decline" for more formal tone.

✏️ Proposed style refinements

-Reservecoins are a novel asset class with distinct benefits and risks. The examples in this article are hypothetical, designed to clearly describe those cases. In practice, benefits and risks occur simultaneously. For instance, a drop in base coin price might increase transactions and fee revenue, causing both a downward price movement from leverage and an upward movement from fees, which may offset each other.
+Reservecoins are a novel asset class with distinct benefits and risks. The examples in this article are hypothetical, designed to describe clearly those cases. In practice, benefits and risks occur simultaneously. For instance, a decline in base coin price might increase transactions and fee revenue, causing both a downward price movement from leverage and an upward movement from fees, which may offset each other.

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 77563de and 6c271b0.

📒 Files selected for processing (3)

• public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md
• public/images/an-overview-of-djed-reservecoins-benefits-risks-and-more.webp
• public/images/reserve-surplus-reserve-coins.webp

🧰 Additional context used

🪛 LanguageTool

public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md

[style] ~72-~72: ‘with respect to’ might be wordy. Consider a shorter alternative.
Context: ...vecoins have a built-in leverage effect with respect to the underlying base coins. When the pri...

(EN_WORDINESS_PREMIUM_WITH_RESPECT_TO)

---

[grammar] ~120-~120: Ensure spelling is correct
Context: ...eservecoin holder wishing to dispose of reversecoins must resort to selling them in a second...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

---

[style] ~131-~131: Try moving the adverb to make the sentence clearer.
Context: ...mples in this article are hypothetical, designed to clearly describe those cases. In practice, benefits and risks occur ...

(SPLIT_INFINITIVE)

---

[style] ~131-~131: Consider a different noun to strengthen your wording.
Context: ...s occur simultaneously. For instance, a drop in base coin price might increase trans...

(DROP_DECLINE)

🪛 markdownlint-cli2 (0.18.1)

public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md

26-26: Images should have alternate text (alt text)

(MD045, no-alt-text)

🔇 Additional comments (2)

public/articles/an-overview-of-djed-reservecoins-benefits-risks-and-more.md (2)

1-7: Frontmatter looks good.

Metadata is properly formatted and includes all necessary fields.

---

9-50: Strong introduction and clear explanation of reserve mechanics.

The explanation of reserve ratios, base coins, and reserve surplus is well-articulated, and the concrete example effectively illustrates the concepts.