Perlドキュメントワーキンググループの立ち上げからの半年の活動報告

こんにちは。id:kfly8 です。

昨年、7月からJPAはPerlを学びやすい環境作りとその支援のために「Perlドキュメントワーキンググループ」という新たな試みを開始しました*1。ここでは立ち上げから約半年の活動報告をします。

1. 翻訳の敷居を下げる

Perlに関する和訳は、長年 argrathとktatに支えられている状況です。私も今回のワーキンググループ立ち上げをきっかけに翻訳をしてみましたが、技術文書ゆえ嘘はつきたくないですし、気を遣う作業の連続で、二人の貢献の偉大さを改めて感じました。一方、perldoc.jp に翻訳が反映されるまでの仕組みの理解は正直難しく、知らない方が多いのではないかと思いました。

ちょっとした一文の翻訳だけでも、技術コミュニティへの貢献になるにも関わらず、その貢献の敷居が高いのは課題だと思いました。

翻訳の敷居を下げるため、次を行いました。

  1. 翻訳のチュートリアルの刷新
    • 具体的には、翻訳データ置き場のmodule-pod-jp というGitHubリポジトリのREADMEを更新しました。(Thanks @bayashi)
    • 翻訳をしたい場合、このmodule-pod-jp を fork して PRを送るだけです。詳しくはREADMEを参照ください。
  2. 対訳表の追加
    • 初めて翻訳をするとき、例えば「void context」を何と訳すべきか戸惑うと思います。そういった問題を解決するために、対訳表を作成しました。 (Thanks @kfly8)
  3. 翻訳の作業ログの追加
    • 実際の作業イメージが湧くように作業ログも追加されました。(Thanks @bayashi)

2. Perlの学び方の現状に関するアンケートの実施

ワーキンググループの立ち上げ当初、どういった活動をするかブレストを行い、沢山のアイデアが見えましたが、的が絞り込めていませんでした。そこでアンケートを実施しました。

blog.perlassociation.org

アンケートの結果、次のアクションをすると良さそうだとわかりました。アンケートにご協力いただいた皆様ありがとうございました！

  1. リファレンス、コンテキストなど初学者がつまづきやすいトピックの入門コンテンツをまとめる
  2. 最近のPerl、今のベストプラクティスなどがわかるコンテンツをまとめる

3. 初学者がつまづきやすいトピックの入門コンテンツをまとめ始めた

アンケートの結果を踏まえ、初学者がつまづきやすいトピックの入門コンテンツを、スプレッドシートにまとめてみました。素朴な人力まとめですが、数を厳選できるので逆に良いのかなと思ってますが、どうでしょうか？実際に使っていただいて、ご意見など伺いたいです。もちろん他にもおすすめしたいコンテンツなどありましたら、教えてください*2。

docs.google.com

4. 最近のPerlの事情がわかるコンテンツの翻訳を始めた

突然の宣伝「3月にYAPC::Kyoto 2023が開催されます！生き生きとした最近の開発の話ができます！YAPC::Kyotoにぜひご参加を！」

ワーキンググループでは、最近のPerlの事情を掴むために、PerlのRFCで受理されたものの翻訳を始めてみました*3。実際に公開したものは以下の通りです。

RFC以外にも、モジュールの翻訳も実施しました。*4

最後に

まだやったら良いことは山積みですが、少しずつでもこういった活動を継続して貢献できればと思っています。 今回の活動内容のご意見、ご感想などあれば、ぜひいただければと思います。

また、活動にご協力いただける方は、ぜひkfly8にお声かけください！私自身、この活動を通じて、知らなかったことに多く出会えて楽しいのでおすすめです👍

*1:開始の告知ブログはこちら。https://blog.perlassociation.org/entry/2022/07/21/103000

*2:掲載の確約ではございません。ご了承のほどよろしくお願いします。

*3:RFCの翻訳はこちらのissueで進行中です。https://github.com/jpa-perl/wg-perl-document/issues/7

*4:モジュールの翻訳については、こちらのissueで検討中です。https://github.com/jpa-perl/wg-perl-document/issues/17

Perlの学び方の現状に関するアンケート結果の簡易レポート

こんにちは。id:kfly8です。

先日、Perlドキュメントワーキンググループの一環で、Perlの学び方の現状に関するアンケートを行いました。回答にご協力いただいた皆さん、ありがとうございました。今後、いただいた情報を元にワーキンググループの活動をしていければと思います。

この記事では、その内容をまとめて報告します。

基礎情報

有効回答数は35件で、うち71.4%の方が現在Perlを書いていただいている方でした。サンプル数としては心ともないため、参考情報としてみていただければと思います。

Perl を初めて学んだとき、インターネットと書籍を組み合わせている方が51%

このアンケートでは、Perl を初めて学んだとき、インターネットから学んでいる方が77%、書籍から学んでいる方が69%いました。利用しているコンテンツの種類は1種類だけでなく、2種類以上組み合わせてるケースが多く、インターネットと書籍を組み合わせている方は51%でした。

Perlを初めて学んだとき、どのように学んだか？

学ぶとき、いくつのコンテンツを利用したか？2種類以上利用しているよう。

インターネットと書籍を組み合わせている方が約半数

Perlを学んだとき、難しいと感じたものは？

Perlを学ぶ時に、「環境構築、Perlのオブジェクト指向、Web開発」などの技術トピックで何が難しかったか質問をしました。回答は「難しいと感じた覚えがない」「難しかった」「非常に難しかった」「学んでいない」から選択する形式で、集計では左から「0点、1点、2点、除外」とラベリングしました。

すると、次の表のとおり「Perlのオブジェクト指向」「リファレンス」が難しいと感じている方が多いことがわかりました。

Perlのオブジェクト指向、リファレンスを学ぶのが難しかったという回答が多かった

技術トピックごとに関連を見ると「環境構築、変数の概念、関数の概念、配列の操作」といったトピックを難しいと感じている方たちと「Perlのオブジェクト指向、正規表現、Web開発」が難しいと感じている方たちで分かれているように見えました。これは、感覚的には、プログラミング初学者関連のトピックとWeb開発関連トピックで分かれていると解釈しました。また、この２つの集団どちらも共通して、「リファレンス」「ターミナルやエディタの操作」といったトピックで難しさを感じていそうです。

トピックごとの相関

Perlのコードを書く際にわからないことがあった時、88.2%の人はインターネットをよく利用する

ここまではPerlの学びはじめを想定した質問でしたが、ここからは現在の状況を伺う質問です。

Perlのコードを書く際にわからないことがあった時、88.2%の人はインターネットをよく利用すると回答しました。 具体的にどういったインターネットサービスを利用しているか集計をとると、「perldoc」「metacpan」「検索サービス」が上位を占めていました。

Perlを学ぶためにあったら良いと思うことは？

Perlを学ぶためにあったら良いと思うことを自由記述で回答してもらいました。複数人から言及のあったトピックは「リファレンスに関する初学者でもわかりやすい入門記事」「最近のPerl、今のベストプラクティスがわかる記事」「Tour of Go、TypeScript playgroundのようなその場で試して、学べるサービス」などがありました。サマリーは次の表の通りです。

Perlを学ぶためにあったら良いと思うことのサマリー

最後に

改めてアンケートにご協力いただいたみなさん本当にありがとうございました。今後の活動のヒントにしていきます！

Perlドキュメントワーキンググループのメンバー公募のお知らせ

こんにちは。id:kfly8です。

Japan Perl Association(JPA)では、日頃、Perlコミュニティに協力をいただきながら、YAPC::Japanといった技術カンファレンスの運営やPerl入学式といった初学者向け勉強会の支援を行っています。

今回、JPAは「Perlドキュメントワーキンググループ(仮称)」という新たな試みを開始します。このワーキンググループは、次のようなことを目指し、定期的にコミュケーションし作業する場です。

  • 和訳に興味があったら、より簡単に参加できる*1
  • ドキュメントの更新日が新しく、情報が信頼できる
  • 目的のドキュメントにたどりつきやすい
  • 最近のPerlの情報をキャッチアップしやすい

これらの事は、このワーキンググループで全て完璧に実現することは難しいですが、継続して取り組み、よりPerlを学びやすい環境作りとその支援をできればと思います。また、ワーキンググループの形を取ることで、コミュニティに参加する人同士の繋がりを楽しみながらできればと思っています！

このワーキンググループに興味のある方は、ぜひ次のフォームからご応募ください。

forms.gle

*1:perldoc.jpではこちらが関連ドキュメント　http://perldoc.jp/about

【解決済】Perlのニュースサイト perl dot com のドメインが何者かによって不正に取得されました

※タイトルはSNS等における自動リンクによるリンク拡散を避けるためにperl​.​comの表記を避けています
※本文のperl​.​comの表記には各種ツール引用後の自動リンク防止のため、ドット前後にUnicodeゼロ幅スペースを入れています

2021/02/03 09:20 JST: 各種CPANクライアントの安全性について誤解を招いているケースが見受けられたので表現を改めました

2021/02/06 22:00 JST: 公式情報が更新されました。ドメイン perl​.​com の奪還に成功し権威DNSは正しいアドレスを返すようになっています。しかし、いわゆるDNS浸透問題によって一部適切に新しいアドレスを返していないDNSキャッシュサーバーが存在するかもしれません。よって、利用する方は注意して利用してください。 正しいアドレスは 151.101.*.*/16 のものです。違うアドレスが返ってくる環境においては正しいアドレスが返る状態になるまで引き続きアクセスを控えてください。

2021/04/12 19:00 JST: 2021/02/05時点でTPFによって安全性が確認されました。

log.perl.org

2021/02/02 20:00 JST現在、ドメイン perl​.​com は何者かに乗っ取られ、ランサムウェアを配布するサイトと同一のIPアドレスに向けられています。

perl​.​com は過去はO'Reillyが所持していましたが、その後The Perl Foundationがそれを引き受けPerlに関するニュースサイトを運営しており、Perlやそのコミュニティに関する記事などが提供されていました。

perldotcom.perl.org

なお、プログラミング言語Perlの公式ドメインは perl.org であり、こちらは乗っ取られていません。 また、（特に影響の大きい） cpan.org について適切に管理されていることをThe Perl Foundationが確認しています。(2/1時点)

CPANの利用、Perlそのものの利用に関して基本的に影響があるものではありません。

Perl開発者が気をつけるべきポイントは以下の2点です。

問題が解消するまではperl​.​comにアクセスしないでください

perl​.​comは現在、悪意のある目的で運用されている可能性があります。 この問題が解消するまではこのドメインへのアクセスは控えてください。

もし、perl​.​com の情報にアクセスしたい場合は、 perldotcom.perl.org を代わりに利用してください。

perldotcom.perl.org

perl​.​comのCPANミラーの利用を停止してください

原則として、どのCPANクライアントもミラーの設定を行なっていないデフォルトの状態でではperl​.​comのミラーを利用する事はありません。

もしperl​.​comのCPANミラーを利用中であれば、これを参照しないようにしてください。 代わりにhttp://www.cpan.org/などの別のミラーを参照してください。

この方法については利用中のCPANクライアントのドキュメントを参照してください。

たとえば、CPAN.pm(cpanコマンド)の場合は以下のとおりです。（TPFの告知情報より引用）

# perl -MCPAN -eshell
cpan shell -- CPAN exploration and modules installation (v2.20)
Enter 'h' for help.

cpan[1]> o conf urllist http://www.cpan.org/
Please use 'o conf commit' to make the config permanent!
cpan[2]> o conf commit
commit: wrote '/root/.cpan/CPAN/MyConfig.pm'

なお、CPAN.pm(cpanコマンド)は特に設定をしていない限りはperl​.​comが利用される事はなく安全です。

よく分からず心配な場合は改めて上記の設定をしておくことをおすすめします。

また、cpanm(App::cpanminus)やcpm(App::cpm)においては、実行時に明示的にmirrorオプションを指定しない限りはcpanmでは www.cpan.orgが、 cpmではcpan.metacpan.orgが利用されるため、明示的にmirrorオプションをperl​.​comに指定しない限りにおいて安全です。 cpanmに関しては環境変数PERL_CPANM_OPTの指定についても確認してください。

Carton/Carmelにおいても同様に明示的に指定しない限りは利用されません。 Cartonに関しては環境変数PERL_CERTON_MIRRORをCarmelに関してはcpanfileのmirror指定を確認してください。

いずれも、詳しい設定内容はそれぞれのドキュメントを参照してください。

以上です。 続報があればこのブログエントリを更新する形でお知らせします。

YAPC::Kyoto 2020の開催見送りを決定しました

2020/02/26 11:52 ... 今後の対応について, 第一報を公開しました.

blog.yapcjapan.org

YAPC::Kyoto 2020を主催するJapan Perl Association (以下JPA) 代表理事の id:karupanerura です。

前回のこちらの記事でお知らせしたとおり新型コロナウイルス感染症（COVID-19）の対策状況などを見て対応を検討しておりましたが、掲題のとおり開催の見送りを決定したことをお知らせします。

blog.perlassociation.org

背景

既にご存知の方も多いと思いますが2/25(火)付で厚生労働省から新型コロナウィルス感染症の基本方針が発表されました。

YAPC::Kyoto 2020を予定通り開催をする上では、すべての来場者が自己責任の上で参加可否を決められるという前提のもと、運営として十分に安心して参加できる状態を作り上げ、かつYAPC::Japanとして提供したい価値をしっかり提供できることが前提になってくると私達は考えました。

COVID-19のYAPC::Japanに対してのリスク評価としては、今後の1~2週間が感染拡大防止のための山場という見解がある一方で、感染が蔓延期に突入することは避けられないという見方もあり、また飛沫感染による感染であるものの必ずしも症状が出ない状態での感染のリスクが指摘されています。3月末という時期とはいえ、何の対策もせずにこれを開催した場合は来場者の間で感染が広がってしまう可能性は高いと判断しました。

多くの来場者は重症化リスクが高くない方であろう一方で、現状では対処療法しか無い状態で僅かながら重症化のリスクもあり、さらには来場者のご家族や関係者の中には高齢者など重症化リスクの高い方が高い確率で含まれると考えられます。

COVID-19に対する見通しが不透明な中、現状のリソースや会場の構成等を加味した上での可能な限りの対策をしたとしてもスタッフを含む関係者・参加者が十分に安心して参加できる状態を整えられる可能性が低く、またYAPC::Japanは日本全国のPerl Mongersが集い交流する貴重な機会でもあるなかでCOVID-19の感染対策によってそれらを支える場が十分に提供できなくなってしまうという判断をした為、このタイミングでの開催は見送らざるを得ないという判断となりました。

今後の予定

今週中を目処に各関係者に連絡を行い、然るべき対応を進めます。 詳細はYAPC::Kyoto実行委員会から今週中を目処に順次ご連絡いたしますのでお待ち頂ければと思います。

本件に関する連絡窓口は yapc-kyoto-2020-core@googlegroups.com となります。

なお、YAPC::Kyoto実行委員会は解散せずに活動を継続し、今後また改めての開催ができないか検討していきます。

YAPC::Kyoto 2020の新型コロナウイルス感染症（COVID-19）に対する対応に関するお知らせ

(2020/02/26追記)

対応が決定しました:

blog.perlassociation.org

(追記ここまで)

YAPC::Kyoto 2020を主催するJapan Perl Association (以下JPA) 代表理事の id:karupanerura です。

掲題の件に関して、新型コロナウイルス感染症（COVID-19）に関しての動向はJPAとしても注視をしており、 YAPC::Kyoto 2020に関わるすべての人達に取ってどのような対応をするのが最善かを、開催中止も視野に入れた上で引き続き慎重に検討しております。

JPAスタッフはもちろん、YAPC::Kyoto運営員会の方々、スピーカー様、スポンサー様、そして参加者の皆様など様々な方々が一丸となり作り上げる本会を滞り無く開催に導きたいという思いは当然あるなかで、本件に関して関係各者の健康と安全を第一に考えると現状では開催中止も視野に入れた検討は必要であると考えております。

YAPC::Kyoto 2020に対する対応に関しての現時点でのJPAとしての決定事項をお知らせ致します。

開催中止と判断した場合の対応

  • チケット
    • 全額の払い戻しを行います
    • すべてのチケットが対象です(例外はありません)
    • 交通宿泊費のキャンセル費用が発生した場合の補填は行いません
  • 学生旅費支援制度
    • 学生側の負担が発生し無いように最大限配慮します
    • 個別個別の状況に応じて相談させて頂くこととなります

スポンサー様、スピーカー様への対応は現時点では未定となりますが、 本会に関して様々な形で貢献して頂いている方々へ最大限負担のかからない形になるよう配慮するためにどのような対応が可能か模索しております。 続報をお待ち頂ければと思います。

開催可否判断時期

2月29日(土) 迄に判断（ただし、状況が想定以上に悪化した場合や別の事由に依って開催に支障が出た場合は別途中止判断を行う場合もある）

以上です。

JPA活動報告を実施し, 2019年度からの新体制を発表しました

4月19日, 日頃よりJPAにご支援頂いている企業様にお集まり頂き, これまでの活動報告と, 2019年度からの新体制について共有させて頂きました.

f:id:japanperlassociation:20190419164001p:plain

2019年度からのJPA新体制について

2019年度より, 以下3名の理事が退任し, 4名の理事が新任されることとなりました.

退任

  • 小林 篤 (代表理事)
  • 田中 慎司
  • 肥後 彰秀

新任

  • 尾形 鉄次
  • 福本 貴之
  • 小林 謙太
  • 小森 一喜

なお, これまで小林篤が務めておりました代表理事については, 新たに佐藤健太が任命されることとなりました.

Japan Perl Associationは, 佐藤健太率いる新体制の元, 日本でPerlを様々な形で活用する企業, そしてPerlを楽しむ人々とコミュニティを繋げ, 支える役割を担ってまいります. 引き続き, 皆様のご支援とご協力の程, よろしくお願いいたします.

© Japan Perl Association since 2009
東京都渋谷区渋谷 1-8-3 TOC 第一ビル8F