Update documentation

Aperta
#249 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
Mezza giornata
Idoneità per principianti
45/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

Start with the README Install section and USER_GUIDE.md, which need a Requirements note, PyPI and source install steps, and a protobuf troubleshooting entry. Check whether #233 and Goal 1 have landed, since they decide which HTA and PARAM steps to remove. Done means following the docs word for word in a clean venv, with chakra_trace_link running on a sample trace and the log attached. Several items depend on unmerged work, so confirm with a maintainer before editing.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Task

  • README: an Install section with pip install mlc-chakra.
  • USER_GUIDE.md:
    • Requirements: agreed Python version.
    • Install from PyPI.
    • Install from source, for contributors: pip install -e . -r requirements-dev.txt.
    • Troubleshooting: a protobuf VersionError means something downgraded protobuf, so run pip install "protobuf>=6.31.1,<8" (#195).
  • Remove the HTA clone steps, if #233 hasn't already.
  • No separate et_replay step (if possible): Goal 1 attempts to make it install with Chakra. Remove the PARAM install step if Goal 1 did what was proposed.
  • C++ feeder: replace the "Execution Trace Feeder" section with a short note explaining what happened with it.

Acceptance criteria

  • Following README and USER_GUIDE word for word in a clean venv on the Python versions works, and chakra_trace_link runs on a sample trace. Evidence: log or CI run.

Depends on

The first release (Goal 5) and et_replay installing (Goal 1).

Under continuous deployment, merging this publishes the next patch, so the PyPI page gets the new README.

Lingua principale
Python
Stelle
201
Fork
87
Merge medio
6g 43m
PR unite (30g)
2

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di mlcommons/chakra

Tutte le issue di mlcommons/chakra

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.