初期コンテンツ作成のお手伝い方法
- 初期コンテンツリストから項目を選ぶ。
- コンテンツをガイドラインに沿って作成する。
- 作成したらリストの項目をチェックする。
- 1 に戻る。
初期コンテンツにおいては、作成しやすさを優先するためシンプルに以下の方針で進めます。
- 内容の吟味は後回しにします。
- 自分の視点でコンテンツを書いて OK です。
- 作成編集時にはイシューやプルリクは不要です。
-
masterに直接プッシュしてください。 - ですので、github のブラウザエディタでも編集できます
📝 - コミットログにイシューのナンバーを書いておくと逆リンクされて便利です。
-
- 誰かが作成した既存のコンテンツも編集して構いません。
- 追加の情報、別のやり方など気軽に投入してください。
- タイポや表記ミスなど簡単なものは、気付いたらそっと直してあげてください。
以下、🚀 は初期コンテンツ作成限定の方針です。
- 前のものを消さずに追記、併記するなどしてください。
- 対応が難しい場合はとりあえず末尾に追記して、リストのイシューにその旨をコメントしてください。
- 🚀 あとで調整しますので、リストのイシューにその旨をコメントしてください。
- 🚀 内容を切り詰めて減らす必要はありません。
- 目安として PC のブラウザでみて 3 スクロールを越えるものは長すぎとします。
- 下限の目安はありません。
- 執筆者が目的が達成できると判断した量でよいです。
- また他の人が見たときに不十分だと判断したら、その人が追記する方針でいきます。
- 某スクリプト言語のレシピ集を参考にしています。
- 項目ひとつひとつを検討はしましたが、まだ的外れな項目や分割統合した方がよい項目などがあるかもしれません 🙇
- 項目自体に疑問や提案などがある場合は、リストのイシューにコメントしてください 🙇♀️
- markdown 記法で書きます。
- ファイル名は
コンテンツのタイトル.mdとします。
- タイトルは動詞で終わる表現に統一します。
- タイトルには半角記号は使わないようにします。
- 必要ならば適宜表現を変えて表記します。
- ❌ 正規表現の「.」に\nをマッチさせる
- ⭕️ 正規表現のドットに改行をマッチさせる
- ❌ リストを「,」区切りで連結して文字列にする
- ⭕️ リストをカンマ区切りで連結して文字列にする
-
コンテンツの一行目に h1 でタイトルを書きます。
# リストを作成する リストを作成するには・・・
- 内容の分量は 3 スクロール以内で表示できる程度にします。
- それ以上必要な場合は項目を分けます。
- コードは haskell のコードブロックで書きます。
返り値を表示したいんだけど？（経緯）
-
返り値を表示する場合は、REPL を使います。
```haskell > replicate 3 "hoge" ["hoge","hoge","hoge"] ```> replicate 3 "hoge" ["hoge","hoge","hoge"]
-
無限リストを表示する場合は、最初の要素をいくつか表示したあと
,...と書きます。```haskell > repeat "piyo" ["piyo","piyo","piyo",...] ```> repeat "piyo" ["piyo","piyo","piyo",...]
main 関数は書いたほうがいいの？（経緯）
- IOが関係しない場合はmain関数はとくに必要ありません。
- IOが関係する場合は基本的にmain関数は書きましょう。
- 例が簡単でREPLで事足りる場合は、REPLのサンプルで済ませてもよいです。
- ただしその場合、REPLの表示上では出力と返り値が区別できない、という点に留意してください。
-
パッケージを利用する際は、
importの前の行にパッケージ名をコメントで書きます。```haskell -- containers import qualified Data.Map as Map import qualified Data.Set as Set ```-- containers import qualified Data.Map as Map import qualified Data.Set as Set
- 大項目（文字列や数値など）において共通するトピックは、
README.mdに書きます。 - 関連する型の概要や、よく使うパッケージの情報などを書くとよいでしょう。