Contributing to MoreBC2
Summary
Section titled “Summary”MoreBC2 is currently a private, source-backed documentation project for BitcoinII (BC2).
This contribution guide is written for trusted reviewers, invited contributors, and agents helping with narrow review tasks.
Do not treat MoreBC2 as public-ready documentation yet.
Current contribution posture
Section titled “Current contribution posture”Until a license and public contribution policy are finalized:
- Treat this repository as private-review material.
- Do not redistribute large portions of the repository.
- Do not publish MoreBC2 pages as official BitcoinII documentation.
- Do not imply that Draft, Partial, or Needs Review pages are final.
- Do not upgrade claims from memory or community assumption.
Core rule
Section titled “Core rule”Document what is verified.
Clearly label what is not verified.
Do not make uncertain material sound more certain than the evidence supports.
Evidence expectations
Section titled “Evidence expectations”When adding or changing a factual claim, identify the evidence source.
Preferred evidence types:
- Current BitcoinII source code.
- Release tag source code.
- Official project website or repository.
- Current release asset or release page.
- Local command test record.
- Direct ecosystem check with date.
- Maintainer statement, clearly attributed.
- Archived historical source for historical claims.
Do not use memory alone as evidence.
Status labels
Section titled “Status labels”Use existing page status labels conservatively:
- Draft — useful structure exists, but not ready to rely on.
- Framework — mostly structure, placeholders, or checklist material.
- Partial — some source-backed material exists, but review is incomplete.
- Reviewed — a meaningful first-pass review exists.
- Needs Review — important material still needs checking.
- Verified — only use when evidence is strong and current.
Do not mark a page Verified without explicit review and a verification block that explains why.
Page verification blocks
Section titled “Page verification blocks”Most pages should end with:
## Verification
**Status:** Draft / Framework / Partial / Reviewed / Needs Review / Verified**Primary sources checked:** ...**Notes:** ...If a page is only a framework, say so.
If command examples are untested, say so.
If ecosystem links are not directly checked, say so.
Command examples
Section titled “Command examples”Command examples are not verified unless they have a test record.
Before adding or promoting a command example, check:
A tested command record should include:
- Date tested.
- Operating system.
- BitcoinII Core version, release, branch, or commit.
- Network mode.
- Node or wallet state.
- Command entered.
- Expected result.
- Actual result.
- Pass/fail.
- Notes.
Do not add wallet-moving, sensitive, or live submission examples to beginner docs.
Release claims
Section titled “Release claims”Release claims must stay conservative.
Before claiming a release artifact is verified, check:
Do not claim that a binary is verified unless hashes and available signatures have been checked.
A GitHub release asset existing is not the same as a verified binary.
A workflow artifact is not the same as a release asset unless it is confirmed on the release page.
Ecosystem claims
Section titled “Ecosystem claims”Do not list explorers, APIs, pools, exchanges, wallets, tools, or services as active unless they have been directly checked.
Every ecosystem listing should include:
- Status.
- URL.
- Last checked date.
- Evidence level.
- Notes.
Do not call a resource official unless an official source says so.
Source review workflow
Section titled “Source review workflow”When reviewing source:
- Name the repository.
- Name the ref: branch, tag, or commit.
- Name the file path.
- Describe only what was actually checked.
- Avoid broad claims about unreviewed files.
- Link related Source Atlas or architecture pages.
- Add open questions for anything unresolved.
If a page is based on main, and a release tag differs, say so.
Suggested feedback buckets
Section titled “Suggested feedback buckets”Use these buckets for issues, review notes, or private comments:
source-mismatchstale-linkunclear-statusunsupported-claimmissing-sourcecommand-not-testedecosystem-needs-checkrelease-verificationwording-polishnavigation-crosslinkopen-questiongood-first-review
Good first contributions
Section titled “Good first contributions”Good first tasks are narrow:
- Fix a broken link.
- Add a missing related-page link.
- Mark an untested command as untested.
- Check one source-backed claim against one source file.
- Add a verification note to one page.
- Add one open question to the backlog.
- Review one explorer/API/pool/exchange listing with a direct date.
Avoid for now
Section titled “Avoid for now”Avoid these until the public contribution process is ready:
- Rewriting many pages at once.
- Marking pages Verified.
- Adding install guides with copy/paste commands.
- Adding wallet movement or recovery guides.
- Adding active ecosystem listings without direct checks.
- Making public launch claims.
- Changing consensus claims without source review.
Pull request or review note checklist
Section titled “Pull request or review note checklist”Before submitting changes or review notes, ask:
- Did I keep Draft/Partial/Needs Review labels conservative?
- Did I separate current facts from research, discussion, and history?
- Did I avoid claiming untested commands are working instructions?
- Did I avoid claiming live services are active without direct checks?
- Did I link any unresolved issue to the verification queue?
- Did I avoid treating MoreBC2 as official BitcoinII documentation?
Use plain, useful language. The site should help newcomers without talking down to experienced users.
Naming standard
Section titled “Naming standard”Use BitcoinII for the project name and BC2 for the ticker. Avoid using Bitcoin2 in MoreBC2 documentation unless quoting or documenting historical third-party usage.
Related pages
Section titled “Related pages”- Docs index
- Private review handoff
- Documentation coverage
- Known unknowns
- Open questions backlog
- Command testing status
- Release artifact checklist
Verification
Section titled “Verification”Status: Draft Primary sources checked: Current MoreBC2 project status, review handoff, verification queue, command tracker, and release tracker Notes: This is a private-review contribution workflow. It is not a final public contribution policy or license statement.