Skip to content

scenario-online: change order of first half work #1701

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 38 additions & 39 deletions tutorial/scenario-online/scenario.rab
Original file line number Diff line number Diff line change
Expand Up @@ -205,20 +205,40 @@ OSSを動かす
(('tag:center'))
(('note:(詳細は後述)'))

(1) 対象OSSを決める
(2) 作業メモを書く場所を用意
(1) 作業メモを書く場所を用意
(2) 対象OSSを決める
(3) 作業メモを書きながら\n
((*公式サイト・README通り*))\n
動かす

= OSSとは
= 作業メモを書く場所を作る

* オープンソースライセンスを\n
設定したソフトウェア
* ((<URL:https://opensource.org/licenses/>))
* ライセンスを確認すれば\n
OSSかどうかわかる
* OSS「っぽい」は存在しない
(('tag:center'))
(('tag:x-large'))
デモ

(1) GitHub: oss-gate/workshop
(2) ↑にissueを作る
(3) 周囲のビギナーの人たちが\n
作ったissueにコメント

= 作業メモの例

ドキュメント通りインストールしたけど
失敗した。

= よりよい作業メモの例

http://... のインストール手順をなぞろう!
(↑後から再度参照できるようにURLも書く)
brewでインストールできるはずなのに失敗した
(↑期待する結果)

% brew install XXX(←なにをしたか)
(...コマンドの実行結果...)
(↑実際の結果)
XXX is not found
↑というようにパッケージがないと言われる

= 対象OSS決め

Expand All @@ -228,6 +248,15 @@ OSSを動かす
* 自分の知らないOSSや言語でもよい\n
(('note:ビギナーと一緒に悩んであげよう!'))

= OSSとは

* オープンソースライセンスを\n
設定したソフトウェア
* ((<URL:https://opensource.org/licenses/>))
* ライセンスを確認すれば\n
OSSかどうかわかる
* OSS「っぽい」は存在しない

= 対象OSS決めのヒント1

* 使っているOSSから選ぶ\n
Expand Down Expand Up @@ -260,40 +289,10 @@ OSSを動かす
= 動かすときのポイント

* 作業メモを書く
* 🔜メモを書く場所はこのあと作る
* なにかする毎に書く
* 例:ドキュメントを読み始めた
* 例:次のドキュメントを読み始めた

= 作業メモを書く場所を作る

(('tag:center'))
(('tag:x-large'))
デモ

(1) GitHub: oss-gate/workshop
(2) ↑にissueを作る
(3) 周囲のビギナーの人たちが\n
作ったissueにコメント

= 作業メモの例

ドキュメント通りインストールしたけど
失敗した。

= よりよい作業メモの例

http://... のインストール手順をなぞろう!
(↑後から再度参照できるようにURLも書く)
brewでインストールできるはずなのに失敗した
(↑期待する結果)

% brew install XXX(←なにをしたか)
(...コマンドの実行結果...)
(↑実際の結果)
XXX is not found
↑というようにパッケージがないと言われる

= ユーザーとして動かす

(('tag:center'))
Expand Down