Improve accessibility of project/tutorial project templates
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Da chiarire
- Stato di attività
- Ferma
- Stack tecnologico
- javascript, python, rust, wasm
- Ambito
- developer-experience, documentation, tooling
Direzione di ricerca
Inizia esaminando la struttura del repository component-docs e la proposta nell’issue #219, quindi confronta le opzioni descritte qui per un singolo repository di primo livello, i tarball Current-release e lo scaffolding specifico per linguaggio. Definisci un percorso di configurazione concordato per le risorse dei tutorial e verifica che copra i workflow Rust, JavaScript e Python menzionati senza richiedere agli utenti di navigare in una sottodirectory annidata.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Currently, new users must clone the component-docs repo, head to a specific sub-directory then attempt to build projects.
It would be ideal if there were easier ways to download and set up resources to walk through the tutorials.
While we probably want to avoid building custom tooling in every possible language (different languages have different scaffolding mechanisms), we need a solution that is a bit less nested.
There were several good suggestions made, one of which being a single repo that contains all the languages at the top level (thanks @mkatychev), which is a bit easier to clone and filter out.
Another suggestion is that this could actually be a part of #219 -- having a "Current" release that always contains tarballs of the current code for any given language might make it easy to download and extract (ex. rust-starter.zip or js-starter.zip).
We could also rely on language-specific templating functionality, but this would likely require ensuring that it exists in the first place for all related languages (i.e. cargo component new, jco new, componetize-py new, etc), or in a shared tool like wit-bindgen which may not be feasible.
- Lingua principale
- Rust
- Stelle
- 137
- Fork
- 88
- Merge medio
- 10h 38m
- PR unite (30g)
- 2
Guida per i contributori
Apri la guida per i contributori
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 bytecodealliance/component-docs
-
Difficoltà 2/5 Mezza giornata Idoneità per principianti 72/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
bytecodealliance/component-docs#294 · 1 commento ·
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 68/100
bytecodealliance/component-docs#376 · 1 commento ·
-
Fix Python Tutorial Apertabug lang/python
Difficoltà 3/5 1-2 giorni Idoneità per principianti 55/100
bytecodealliance/component-docs#348 · 2 commenti ·
Tutte le issue di bytecodealliance/component-docs
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100
-
bug core
Difficoltà 2/5 1-3 ore Idoneità per principianti 86/100
-
JIT-compiled number -> Decimal conversion silently overflows instead of raising DECIMAL_OVERFLOW Apertafuzz
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
ClickHouse/ClickHouse#122114 ·
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 92/100
linebender/vello_svg#90 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100