docs(editorial-style-guide): Fix redundancy, markdown escapes, and add Builder Quick Reference cheat sheet
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Idoneità per principianti
- 68/100
- Tipo di issue
- Documentazione
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- markdown
- Ambito
- documentation
Direzione di ricerca
Trova la guida di stile editoriale menzionata nell’issue e leggi l’introduzione e le sezioni «Critical Style Conventions» e «Punctuation». Controlla l’istruzione ripetuta e gli asterischi con escape, poi confronta la tabella di riferimento rapido proposta con il resto della guida. Il lavoro è completato quando la duplicazione e la formattazione sono corrette e la tabella è aggiunta nella posizione richiesta.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Summary & Context
In response to @jesse.base.eth's open bounty (Warpcast Cast), this contribution proposes concrete improvements to to enhance editorial clarity, fix formatting discrepancies, and provide an instant cheat sheet for onchain builders.
1. Fix Redundancy in Critical Style Conventions
Under :
- Current text:
- Issue: The exact same instruction is duplicated back-to-back within the same bullet point.
- Proposed Fix:
2. Fix Broken Markdown Escapes in Punctuation
Under :
- Current text:
- Issue: Escaped raw asterisks render literal backslashes rather than highlighting the bold comma.
- Proposed Fix:
3. Proposed Addition: At-A-Glance Builder Quick Reference Table
Builders often need a quick lookup rather than reading the entire guide. Adding this summary table right after the introduction drastically improves document usefulness:
| Term / Concept | ✅ Use This | ❌ Avoid / Do Not Use |
|---|---|---|
| Network Name | Base | BASE, Base Chain, Base Network, |
| Industry / Movement | onchain, Onchain | web3, crypto, on-chain, On-Chain |
| Ecosystem Standing | Ethereum L2, onchain economy | alt-L1, sidechain, eth killer |
| Partnership Order | ||
| Value Proposition | utility, experience, access, community | 100x gains, pump, speculative returns, token price |
| Typography / Case | Title Case for headlines | Sentence case or ALL-CAPS |
| Punctuation | Oxford comma (A, B, and C) | A, B and C (missing Oxford comma) |
4. Proposed PR
I have prepared the corresponding patch and am ready to submit a pull request if the core team would like to merge these refinements directly.
💰 Bounty Settlement (Base EVM):
cc @bountybot
- Lingua principale
- Nessun dato sulla lingua
- Stelle
- 1.5k
- Fork
- 533
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di base/brand-kit
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
-
Add a quick-start section for engineers (formats, preferred files, and usage tips)Forse già presa @faisalnugroho l’ha presa 139 giorni fa. Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
шефAperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 15/100
-
началоAperta
Difficoltà 5/5 Più di una settimana Idoneità per principianti 10/100
Tutte le issue di base/brand-kit
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
aws-samples/sample-per-model-bedrock#261 ·
I maintainer di solito rispondono entro 1 giorno
-
Check Trellix Links...Aperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
NetAppDocs/ontap#2151 ·
-
documentation
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
nf-core/metaboigniter#132 ·
I maintainer di solito rispondono entro 1 giorno
-
readme需要更新desktop的安装命令Apertaroadmap
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
dsh-market/dsh-market#887 ·
I maintainer di solito rispondono entro 1 giorno
-
documentation hacktoberfest priority: low skill: good first issue status: ready for dev
Difficoltà 2/5 Mezza giornata Idoneità per principianti 85/100
hyperledger-labs/fabric-smart-client#2142 ·
I maintainer di solito rispondono entro 1 giorno