quarto-dev / quarto-dev/quarto-cli
Consistency needed CLI/WEB: "code cell" or "code chunk"?
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
Discussed in https://github.com/quarto-dev/quarto-cli/discussions/6151
Originally posted by mine-cetinkaya-rundel July 9, 2023
Quarto documentation refers to both "code chunks" and "code cells". Quarto internals generally refer to code cells. It would be good if we could settle on a term and use it, but this might be impossible. I still wanted to record this discussion here, in case others have thoughts and want to chime in.
Some points to keep in mind:
- R Markdown and knitr refer to them as "chunks"
- Jupyter refers to them as "cells" (https://jupyterbook.org/)
- Pluto.jl also refers to them as "cells" (https://plutojl.org/)
Originally posted by mcanouil July 15, 2023
Few statistics:
- In https://github.com/quarto-dev/quarto-web:
- "code chunk" is used 94 times in 36 files.
- "code cell" is used 269 times in 90 files.
- In https://github.com/quarto-dev/quarto-cli:
- "code chunk" is used 61 times in 18 files.
- "code cell" is used 138 times in 41 files.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the terminology discussion in issue #6220 and the reported occurrences in the quarto-web and quarto-cli repositories. Establish whether one term can be selected across the documentation and internals, then update the affected references consistently and verify that no relevant usage was missed.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100