search

oss-gate / workshop

OSSの開発に未参加または参加したことはあるけどまだ自信がない人を後押しするワークショップ用のリポジトリー
124 stars 547 forks source link

OSS Gate Workshop: online: 2024-01-27: びきニキ: doc-ja : Work log #1774

Closed 012xx closed 10 months ago

012xx commented 10 months ago

This is a work log of a "OSS Gate workshop". "OSS Gate workshop" is an activity to increase OSS developers. Here's been discussed in Japanese. Thanks.

作業ログ作成時の説明

以下のテンプレートを埋めてタイトルに設定します。埋め方例はスクロールすると見えてきます。

OSS Gate Workshop: ${LOCATION}: ${YEAR}-${MONTH}-${DAY}: ${ACCOUNT_NAME}: ${OSS_NAME}: Work log

タイトル例↓：

OSS Gate Workshop: Tokyo: 2017-01-16: kou: Rabbit: Work log

OSS Gateワークショップ関連情報

012xx commented 10 months ago

OSS決めを始めます📛

気になってるのは以下の通りだけど、どっちも有名すぎて悩んでいる

最近使ってるソフト（他の候補）が浮かんでこない～～～

012xx commented 10 months ago

決められるのか不安になってきたぞ！

012xx commented 10 months ago

doc-ja :https://github.com/php/doc-ja

012xx commented 10 months ago

web-php: https://github.com/php/web-php/tree/master

012xx commented 10 months ago

ライセンス：https://github.com/php/doc-base/blob/master/LICENSE https://creativecommons.org/licenses/by/3.0/deed.ja

doc-base: https://github.com/php/doc-base/tree/master

doc-jaに「ライセンス情報が無いこと」を聞くとか？

012xx commented 10 months ago

てきめんさんのPR 参考になるかも：https://github.com/php/php-src/issues/11878

012xx commented 10 months ago

ライセンス：https://github.com/php/doc-ja/blob/master/bookinfo.xml

012xx commented 10 months ago
012xx commented 10 months ago

リポジトリをローカルに落としてVSCodeで見てもらうとかもあり？

012xx commented 10 months ago

doc-ja :https://github.com/php/doc-ja の誤字脱字を見ることにした

youkidearitai commented 10 months ago

Creative Commonsはオープンソースではないが、Creative Commons Attribution 3.0（CC BY）は自由なライセンスの一部であると考えます。

012xx commented 10 months ago
012xx commented 10 months ago

拡張子を変えるのは微妙なので一旦保留かなあ http://doc.php.net/tutorial/local-setup.php ページ以外のコードもmdぽい

012xx commented 10 months ago
012xx commented 10 months ago

.mdのスタイルを決めてるファイル見つけたらハイライトのところも貢献できそう？

012xx commented 10 months ago

https://github.com/php/web-doc/blob/master/include/Parsedown.php ここらへんは生成してるコード

daipom commented 10 months ago

ウェブサイトとして異なるものなので、異なる仕組みになっていそうな気がしますね。 なるべく揃えた方が良いんじゃないかというのはその通りだと思います！

ただ、仕組みが異なるのであれば、もしかしたら簡単には揃えられないのかも、、

シンプルに、doc.php.netの方のコードブロックが見にくいので、www.php.netみたいな感じにならないかなあ、みたいな気持ちを伝える方向性でフィードバックするのでよさそうな気もします！

daipom commented 10 months ago

  • 斜体文字は折り返しが効いておらず、SPにした際にはみ出している

  • 実機で見た時も同じ

おお、合わせてフィードバックしたらよさそうですね！ ブロックの改善！

012xx commented 10 months ago

https://github.com/php/web-doc

012xx commented 10 months ago

Readmeが分かりにくいという提案 https://www.php.net/manual/ja/faq.mailinglist.php

daipom commented 10 months ago

メーリス一覧。ドキュメント用のメーリスが最後にある

https://www.php.net/mailing-lists.php

012xx commented 10 months ago

phpdoc@lists.php.net

012xx commented 10 months ago

今ある問題点

012xx commented 10 months ago

phpdoc@lists.php.net に送られてきたメールの一覧？ https://news-web.php.net/group.php?group=php.doc

youkidearitai commented 10 months ago

@012xx ここ https://www.php.net/mailing-lists.php にphpdoc@lists.php.netがあるのですが、アーカイブを見るとほとんどVCS Account Requestで使われてるので単純なIssueだったらそのままGitHub Issueに投稿してしまって良いと思います。

012xx commented 10 months ago

ありがとうございます！一旦Issue作ってみます👀

012xx commented 10 months ago

@youkidearitai 立ててみました！レビューお願いします（ドキドキ） https://github.com/php/web-doc/issues/46

github-actions[bot] commented 10 months ago

おつかれさまでした！

ワークショップの終了にともないissueを閉じますが、このまま作業メモとして使っても構いません :ok_hand:

ワークショップの感想を集めています！

ブログなどに書かれた際は、このページへリンクの追加をお願いします :pray:

またの参加をお待ちしています！