Review: writing_good_code.md

Open Beginner friendly
#63 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
python

Research direction

Open lectures/writing_good_code.md in the French repository and compare it with the English source at the linked path. Review meaning, technical terms, terminology consistency, academic French, and code comments while following the exclusions in the issue; done when a PR for this file is merged or the reviewer confirms no changes are needed.

Written by the indexing model from the issue text.

Description

audit maintenance

Part of #40 (Phase 1).

Native-speaker review of writing_good_code.md by @Honaminto.

French (read this) lectures/writing_good_code.md
English source lectures/writing_good_code.md

How to reply. Open a PR editing the French directly — one PR for this lecture, titled e.g. [writing_good_code] Corrections — or leave line comments / suggestion blocks on it. Priorities: meaning errors, wrong technical terms, inconsistent terminology, unnatural French (academic register), anything in code comments that looks wrong. Ignore spacing before : ; ! ?, errors in the English, and the translation: header. A wrong term that recurs belongs on the terminology issue, not here.

Done when a PR by @Honaminto touching this file is merged, or he states here that the lecture needs no change. Either outcome is recorded; nothing is ticked by hand.

Dominant language
Python
Stars
0
Forks
1
Avg merge
41m
Merged PRs (30d)
3

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from QuantEcon/lecture-python-programming.fr

All issues in QuantEcon/lecture-python-programming.fr

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.