google/comprehensive-rust

Update exercise boiler plate text to suggest working on the code locally

Open

#1,289 建立於 2023年10月2日

在 GitHub 查看
 (5 留言) (0 反應) (0 負責人)Rust (32,954 star) (2,009 fork)batch import
enhancementgood first issuehelp wanted

描述

As pointed out in https://github.com/google/comprehensive-rust/pull/1288#issuecomment-1743131185, we're giving mixed signals about how the exercises should be solved: in the Rust Playground or locally with Cargo?

This is mostly a remnant of how the course has evolved: it started out being very focused on the Playground, but later we started recommending a more regular Rust setup.

We should update the boiler plate text to be more consistent and to encourage people to use a local installation.

To streamline things, we could include the same text (using the mdbook {{#include }} syntax) from all the exercises and thus ensure everything is consistent.

貢獻者指南

技術棧
rust
領域
documentationcontent
議題類型
documentation
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
2
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
fresh
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
familiarity with mdbookbasic Rust knowledgegit and GitHub workflow
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
90
研究方向
Review the comment in PR #1288 for the specific suggestion. Locate the exercise boilerplate files (likely in the `exercises` directory) that contain the text to be updated. Ensure consistency by using `{{#include}}` to include a common text snippet. Verify that the new text encourages local Cargo usage while still mentioning the playground as an option. After making changes, run `mdbook build` to ensure the book compiles correctly.