Skip to content

Conversation

KuraZuzu
Copy link
Contributor

@KuraZuzu KuraZuzu commented Aug 6, 2025

What does this implement/fix?

READMEのフォーマットを修正し、可読性をあげます。

Does this close any currently open issues?

しません。

How has this been tested?

テストはしていません。ドキュメントの整備のみです。

Any other comments?

英語と日本語のREADME両方が対象です。

現在のデフォルトであるros2ブランチと、README整備用のfix/readmeブランチのREADMEを直接見ると比較しやすいと思います

Checklists

@KuraZuzu KuraZuzu requested review from YusukeKato and Kuwamai August 6, 2025 02:29
@KuraZuzu KuraZuzu self-assigned this Aug 6, 2025
@KuraZuzu KuraZuzu added the Type: Documentation Documentation only changes label Aug 6, 2025
Copy link
Contributor

@YusukeKato YusukeKato left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

いくつかコメントしましたのでご確認をお願いいたします。
日本語のREADMEにコメントしたので修正する場合は英語版にも反映いただけたらと思います。

@KuraZuzu
Copy link
Contributor Author

KuraZuzu commented Aug 8, 2025

@YusukeKato
レビューありがとうございました。修正しましたのでご確認をお願いします。

Copy link
Contributor

@YusukeKato YusukeKato left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

レビュー対応ありがとうございます。
一箇所だけ修正忘れがあったので確認をお願いいたします。

Copy link
Contributor

@YusukeKato YusukeKato left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

問題ないかと思います。

Copy link

@Kuwamai Kuwamai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

少しだけ要望追加しました! ご確認お願いします 🙇

README.en.md Outdated
Comment on lines 90 to 94
- raspimouse_gazebo
- [Joystick Control](./raspimouse_gazebo/README.md#joystick-control)
- [Object Tracking](./raspimouse_gazebo/README.md#object-tracking)
- [Camera Line Follower](./raspimouse_gazebo/README.md#camera_line_follower)
- [SLAM & Navigation](./raspimouse_gazebo/README.md#slam--navigation)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

今後のメンテナンス時に変更箇所が増えてしまうので、ここは削除してREADMEの案内のみでお願いしたいです。

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こちらについて一点意見があります。

リポジトリトップのREADMEを見た際に、どのような名前のサンプルが用意されているか把握できる形式としたほうが個人的にはわかりやすいと思います。ですので、各種サンプルに対してのリンクは削除して一覧を残すという方針はいかがでしょうか。

一度以下のような形式にしてみました。(箇条書きトップのraspimouse_gazeboの記述も、自明なので削除しています)


How to Use Examples

Detailed usage of the sample program is explained in the README of the raspimouse_gazebo package.

  • Joystick Control
  • Object Tracking
  • Camera Line Follower
  • SLAM & Navigation

README.md Outdated
Comment on lines 90 to 94
- raspimouse_gazebo
- [Joystick Control](./raspimouse_gazebo/README.md#joystick-control)
- [Object Tracking](./raspimouse_gazebo/README.md#object-tracking)
- [Camera Line Follower](./raspimouse_gazebo/README.md#camera_line_follower)
- [SLAM & Navigation](./raspimouse_gazebo/README.md#slam--navigation)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

こちらも削除でお願いします。

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

上記のREADME.en.mdと同じ意見です。

```sh
ros2 launch raspimouse_ros2_examples teleop_joy.launch.py joydev:="/dev/input/js0" joyconfig:=f710 mouse:=false
```

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

日本語版も同様に横線の追加お願いします。

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

追加しました。

@KuraZuzu
Copy link
Contributor Author

KuraZuzu commented Sep 3, 2025

@Kuwamai レビュー修正とコメントをしました。ご確認をお願いします。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: Documentation Documentation only changes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants