Skip to content

Commit fc3f36b

Browse files
authored
scenario-online: change order of first half work (#1701)
最近はこの順番でやっていると思うので、スライドに反映したほうが良さそうと思いました。 僕が見習ったpiroさんの手順が先にメモを作るやり方だったので、元々のやり方のイメージがあまりないですが、 「対象OSSを決める」部分で結構悩まれる方もいるので、先にメモを作ってから対象OSS決めに入ってもらう手順の方が良いだろうと思っています。
1 parent d9d20bb commit fc3f36b

File tree

1 file changed

+38
-39
lines changed

1 file changed

+38
-39
lines changed

tutorial/scenario-online/scenario.rab

Lines changed: 38 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -205,20 +205,40 @@ OSSを動かす
205205
(('tag:center'))
206206
(('note:(詳細は後述)'))
207207

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

214-
= OSSとは
214+
= 作業メモを書く場所を作る
215215

216-
* オープンソースライセンスを\n
217-
設定したソフトウェア
218-
* ((<URL:https://opensource.org/licenses/>))
219-
* ライセンスを確認すれば\n
220-
OSSかどうかわかる
221-
* OSS「っぽい」は存在しない
216+
(('tag:center'))
217+
(('tag:x-large'))
218+
デモ
219+
220+
(1) GitHub: oss-gate/workshop
221+
(2) ↑にissueを作る
222+
(3) 周囲のビギナーの人たちが\n
223+
作ったissueにコメント
224+
225+
= 作業メモの例
226+
227+
ドキュメント通りインストールしたけど
228+
失敗した。
229+
230+
= よりよい作業メモの例
231+
232+
http://... のインストール手順をなぞろう!
233+
(↑後から再度参照できるようにURLも書く)
234+
brewでインストールできるはずなのに失敗した
235+
(↑期待する結果)
236+
237+
% brew install XXX(←なにをしたか)
238+
(...コマンドの実行結果...)
239+
(↑実際の結果)
240+
XXX is not found
241+
↑というようにパッケージがないと言われる
222242

223243
= 対象OSS決め
224244

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

251+
= OSSとは
252+
253+
* オープンソースライセンスを\n
254+
設定したソフトウェア
255+
* ((<URL:https://opensource.org/licenses/>))
256+
* ライセンスを確認すれば\n
257+
OSSかどうかわかる
258+
* OSS「っぽい」は存在しない
259+
231260
= 対象OSS決めのヒント1
232261

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

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

268-
= 作業メモを書く場所を作る
269-
270-
(('tag:center'))
271-
(('tag:x-large'))
272-
デモ
273-
274-
(1) GitHub: oss-gate/workshop
275-
(2) ↑にissueを作る
276-
(3) 周囲のビギナーの人たちが\n
277-
作ったissueにコメント
278-
279-
= 作業メモの例
280-
281-
ドキュメント通りインストールしたけど
282-
失敗した。
283-
284-
= よりよい作業メモの例
285-
286-
http://... のインストール手順をなぞろう!
287-
(↑後から再度参照できるようにURLも書く)
288-
brewでインストールできるはずなのに失敗した
289-
(↑期待する結果)
290-
291-
% brew install XXX(←なにをしたか)
292-
(...コマンドの実行結果...)
293-
(↑実際の結果)
294-
XXX is not found
295-
↑というようにパッケージがないと言われる
296-
297296
= ユーザーとして動かす
298297

299298
(('tag:center'))

0 commit comments

Comments
 (0)