Skip to content

docs: Improve README with Development Setup and Project Structure sections#382

Closed
maojianian25-png wants to merge 1 commit into
INDIGOAZUL:mainfrom
maojianian25-png:docs/improve-readme-dev-setup
Closed

docs: Improve README with Development Setup and Project Structure sections#382
maojianian25-png wants to merge 1 commit into
INDIGOAZUL:mainfrom
maojianian25-png:docs/improve-readme-dev-setup

Conversation

@maojianian25-png

Copy link
Copy Markdown

Summary

Closes #50

Improved the README.md with better onboarding information for new developers.

Changes

1. Development Setup Section (NEW)

  • Explains this is a static site with no build step
  • Prerequisites: Node.js v18+ (only for npx serve)
  • Step-by-step local serving instructions using npx serve .
  • Alternative methods: Python, PHP, VS Code Live Server
  • Project architecture explanation
  • Key files reference table

2. Project Structure Section (IMPROVED)

  • Expanded from 8 lines to a comprehensive tree with annotations
  • Covers all key directories: css/, js/, assets/, chain/, components/, packages/sdk/, translations/, i18n/, .github/
  • Each directory has inline comments explaining its purpose
  • Matches the actual codebase structure

3. Quick Start Section (IMPROVED)

  • Translated to English (README is developer-facing per requirements)
  • All links verified working

Definition of Done

  • README has clear development setup instructions (npx serve .)
  • Project structure section matches reality (verified against actual file tree)
  • All links verified working (Swagger UI, Dev Portal, Chain Explorer)
  • No duplicate content from CONTRIBUTING.md
  • Only README.md was modified (no new doc files)
  • All text in English

Codebase Verification Answer

Where does marketplace-social.js live?
At the HTML root directory (not in js/). Referenced in marketplace-social.html as <script src="marketplace-social.js">.

What is the name of the main API file?
api-proxy.js (located at the HTML root).


Reward tier: Tier 0 (50 LTD)

…tions

- Added Development Setup section explaining how to serve locally (npx serve .)
- Added Project Architecture explanation (static site, no build step)
- Added Key Files reference table
- Expanded Project Structure to match actual codebase layout
- Translated Quick Start section to English (developer-facing README)
- Verified all links (Swagger UI, Dev Portal, Chain Explorer)
- No new doc files created (README.md only, as required)

Codebase verification: marketplace-social.js lives at HTML root (not in js/).
Main API file: api-proxy.js.

Closes INDIGOAZUL#50
@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown

PR Gatekeeper

This PR has been automatically closed. Follow the process in CONTRIBUTING.md and try again.

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.

📖 Developer Documentation Page — 50 LTD Bounty

1 participant