b-wind

Results 4 comments of b-wind

> そもそも必要か? 記述場所自体は別個の物としては不要かと Wiki にページ追加して行くものかなと。 > 使うならどんな位置づけにする? FAQ や Q&A と個別の How To は別の物と思います。 FAQ 等から参照される詳細情報(個別手順)として有った方が良いと思われます > どうやって記載内容を決めていく? 実際に作成してみて、後から整理したり課題・問題が出れば解決して行けば良いものかと思われます。 一つ一つに対してはあくまで手元で作業した事例にしかなり得ません。 実際に試した人からのフィードバックは欲しいですね。

> 専用のRepositoryを一つ作成する事になる これがちょっと分からないところですね。 Github Pages を使って作るからと言う意味でしたら、「その必要はあまり感じ無い」という意味で1は必要ないと言う主張をしています。( cocoa-documentation リポジトリで別途 Github Pages を作ることも出来ます ) Wiki では表現しにくい様な複雑な構成のページを作成するのでしょうか? 念の為ですが、Github の Wiki ページでも画像の貼り付け程度は出来ますよね。

> 「GitHubを使い慣れていない人」や「Wikiって何?」という人に向けて > 情報を公開する場所があった方がいいのでは?という この場合、Github Wiki+Markdown を利用する場合と HTML+CSS+git を利用する場合の比較になると思います。 少なくともリポジトリ作成時に git は苦手という事を聞いたので Wiki 中心で推しています。 Github 固有の部分は少ないので基本的には Wiki の編集に慣れて欲しいとは思っています。 Markdown 自体に慣れていない場合は補助するEditorの利用も検討してみても良いかなと。 https://ckeditor.com/github-writer/ > GitHubを知らない人にとっては「Wikiを見てください」と言っても > 必要な情報にたどり着けない状態になってしまうかなと思っています。 見る側にとってWikiで出来ているのかどうかはあまり関係内容に思えますが、どうでしょうね。 ただし、あまり見栄えや見やすさに考慮したもので無い、と言う問題はあります。 Github Actions 等と連携させる必要がありますが、Github...

こう言う物は有った。 https://github.com/joshfraser/pubsubhubbub-php