fix: clear remaining afdocs content-start, fence, and parity fails - #551
Open
owans wants to merge 1 commit into
Open
fix: clear remaining afdocs content-start, fence, and parity fails#551owans wants to merge 1 commit into
owans wants to merge 1 commit into
Conversation
Expand Supported Wallets, drop the commented Atlas fence, and unwrap MDX widgets so markdown matches HTML on the five failing pages. Co-authored-by: Cursor <cursoragent@cursor.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.OpenSSF Scorecard
Scanned Files |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates several documentation pages to resolve afdocs parity and formatting failures by replacing MDX widgets with plain Markdown, removing problematic commented content, and expanding/clarifying key guide sections so rendered HTML and source .md align.
Changes:
- Replaced MDX components (DocCardList, Tabs, Steps, Accordion) with plain Markdown lists/headings to improve parity.
- Removed an HTML-commented ASCII fence in the Atlas getting-started guide that afdocs treated as unclosed.
- Expanded/clarified content in PowPeg supported wallets and several developer guides to satisfy afdocs content-start and parity checks.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/06-use-cases/interoperability/index.md | Replaces DocCardList with explicit Markdown implementation-guide links and adds spacing for clearer parsing. |
| docs/05-dev-tools/dev-environments/index.md | Adds a Markdown list of supported environments ahead of the existing CardsGrid. |
| docs/04-resources/07-hackathon/index.md | Replaces Tabs-based prerequisites with Markdown sections for beginners/experienced developers. |
| docs/04-resources/06-guides/powpeg-app/advanced-operations/supported-wallets.md | Expands “supported wallets” into structured sections, steps, and related links. |
| docs/04-resources/06-guides/atlas/getting-started-atlas.md | Removes the commented ASCII diagram containing a fenced code block. |
| docs/02-developers/05-smart-contracts/06-rsk-cli/introduction.md | Replaces Accordion widget with Markdown headings and bullet lists; removes “Smart Bitcoin” wording. |
| docs/02-developers/04-quickstart/dynamic.md | Replaces Steps/Tabs MDX with Markdown headings and lists; fixes dashboard image alt text typo. |
Suppressed comments (1)
docs/02-developers/04-quickstart/dynamic.md:193
- Like the install step above, these two commands are alternatives; presenting them as separate blocks without “choose one” guidance can lead to users running both and getting conflicting lockfiles/scripts.
Start the development server using Bun or Yarn.
```bash
bun dev
</details>
---
💡 <a href="/rsksmart/devportal/new/main?filename=.github/skills/code-review/SKILL.md" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Add a `code-review` agent skill</a> or configure MCP servers for context-aware, tailored reviews. <a href="https://docs.github.com/en/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review#mcp-servers-and-agent-skills" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Learn more in the docs.</a>
| Explore the recipes below to start integrating bridging solutions into your application. | ||
|
|
||
| <DocCardList /> No newline at end of file | ||
| - **[Build Omnichain Fungible Token (OFTs) on Rootstock with Layerzero](/use-cases/interoperability/rootstock-layerzero/)**: Cross-chain token transfers using OFT between Rootstock and other supported chains. |
Comment on lines
+144
to
+152
| Install the necessary dependencies with either Bun or Yarn. | ||
|
|
||
| ```bash | ||
| bun install | ||
| ``` | ||
|
|
||
| ```bash | ||
| yarn install | ||
| ``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.mdmatches HTML on Dynamic, rsk-cli intro, Dev Environments, Hackathon, and Interoperability.Test plan
/resources/guides/powpeg-app/advanced-operations/supported-wallets/has hardware/software sections and related links./resources/guides/atlas/getting-started-atlas/has no```inside HTML comments.###feature headings and does not say Smart Bitcoin.npx afdocs check https://dev.rootstock.io --fixes --verbose(this run still samples production).Made with Cursor