539 Matching Annotations
  1. Apr 2025
    1. Web フレームワーク

      WebフレームワークとWebアプリケーションフレームワークという表現があるので、どちらかに統一して欲しい

    2. ツールやコンポーネントの集合体

      ツールキットがツールやコンポーネントの集合体、だと一般名詞を一般名詞で説明しているイメージで、あんまりピンとこないです。どう書くといいんだろう...

    3. Toolkit

      上の図では「Tool Kit」となっているので、統一した方がよいかと。というか図の中でも「Webツールキット」と書いた方がよいと思います

    4. この段階でWebツールキットとはなにかとかを書いてくれた方が、読者は興味を持ってもらえるかなと思いました。

      Webツールキットとはなにか、なぜWebツールキットの役割と機能を今回は紹介するのか、といった問いに書き出しで答えて欲しいなと思います。

  2. Mar 2025
    1. 可能になります。

      現時点ではまだ「能力を活かした〜可能になります」と言い切るのは早いのでは。

      今後可能になります、程度かなと

    2. 概要といろいろ試してみた実験を中心に紹介します

      ちょっと日本語が読みにくいです。

      いろいろ試してみた、がなにを試したのか?となるので読みにくいのかなぁ

      後半では動作検証とあるので、言葉を合わせた方がいいかなと思います。

      についての概要と動作検証した結果を紹介します。

      とか

  3. Feb 2025
    1. 非推奨警告をするには

      可能なら、これはなんのためのものなのか?を説明してほしいです。

      ライブラリ等を更新していて、削除予定の関数があったら~~みたいな

    2. nsider renaming '/home/ub

      スクロールしないと大事なところが見れないので、改行するか、大事なポイントを説明文で補足してほしい

      consider... 以降を日本語で、こういう意味だよって説明してほしい

    3. また、

      ここは別の話だと思うので、

      エラーメッセージのカラー化(これは対話型インタプリタの機能)

      と、secrets.pyの衝突は別の見出しがよいと思います。 こっちは「Improved error messages」の文脈

  4. Jan 2025
    1. 処理の内容が把握しやすくなっています

      把握しやすくなった反面、前の方に書いてた「最後の実行結果が表示される」が使えなくなっていると思うので、そのことを補足した方がよいかと。

      どっちを使うかはお好みでって感じですかねぇ

    2. Excelブックを開いたときにコメントが表示されません。

      コメントが表示されず [PY]DataFamre と表示されています。

      とか

    3. 問題1.

      図がはさまったことにより、「問題1ってなんだっけ?」ってなるので「問題1.コードが長く読みにくい」みたいな、どういう問題かを説明する短い文がほしい

    4. Python in Excelの実行順序

      nits: 矢印が細かいので、もっと行を少なくして読者に伝える情報を減らした方が見やすいと思います。

      3~4行くらいあればいいので、矢印をもっと太くして、右上から左下に移動する斜めの矢印もほしい

    5. 内容を確認したい変数を最後の行に書いておくと、値の確認ができます。

      Jupyter Notebookっぽい動作だなって思うので、そういうたとえがあってもいいかなと思いました。

      Jupyterを知っている人には「あー、あれと同じね」みたいに思ってもらって理解しやすいかなと

  5. Dec 2024
    1. large-v3-turbo

      whisper.cppだけturboにしているのはなぜですか?

      速度比較をするのであれば同じモデルを使ってほしい。 large-v3-turboモデルはlarge-v3よりも速いです。

    2. 筆者のローカル環境で

      どういう機種か、スペックを書いてほしい

      APIとGPUはローカル環境じゃないので、別枠で書いた方がいいかなと思いました。

    3. 以下はlargeモデルを使用した場合の結果です。

      コードのここを書き換えたよ、は書いてほしい。 initial_promptはそのままなんですよね?

    4. pipはpython 3.4 以降では標

      これも引用かなにかで別途書き出して「ここが改善された」とわかるようになっているといいなと思いました

    5. pipはPython3.4以降では標準でイン

      SHOULD: preタグで書かれるとgihyo.jp側でもスクロールしないと読めないので読みにくいです。

      引用にするか、あとはなにか良い方法あるかなぁ。

    6. voice_sample.m4a

      ためせるようにこの音声ファイルも置いてくれるとうれしいなー。

      自分の声が恥ずかしかったら、なにかの読み上げソフトで読み上げた音声(ライセンス上問題ないもの)を置くのもありかと。

      あとはPyCon JPとかの発表動画からカットして使うとかもありかも

    7. # 最新版をインストールするには以下を実行します % pip install git+https://github.com/openai/whisper.git

      紹介しなくてもいいんじゃないかな よくかわっていない人はこの2つのpip installを実行しちゃいそう

    8. OSS版を使用するにはpipで

      nits

      OSS番のwhisperを利用するには、

      とか。pipでなにをインストールするの?と思ったので

    9. OSS版の利用にはPython 3.8 〜 3.11 までとなっています。

      日本語が変かなと

      OSS版がサポートするPythonバージョンは、とか

    10. Whisperで扱うことのできるファイル形式

      これってどこに書いてました? 内部的にはffmpegで変換していると思うので、ffmpegが処理できるファイル形式ならなんでもいけるかなと思っていました

    11. それぞれに英語のみのモデルと多言語モデルがあります。

      nits: 「それぞれに」だと全部にありそうに見えるけど、large, turboにはenはないので、なにかいい表現があるといいかなと。

      一部には英語のみ~

      とか?

  6. Oct 2024
    1. t.session_state.dices.append

      これ、ここは書き換えないで if 文の手前で

      dices = st.session_state.dices

      とすればいいのでは(そうしたら他は書き換えなくていい

    2. if "dices" not in st.session_state: # セッションデータの初期化 st.session_state.dices = []

      streamlitのサンプルコードでもこうなっていますが、

      not inで存在チェックしているのに、初期化するときは属性になっているので少しトリッキーだなと思いました。 そこについて説明してほしいです。

      st.session_state["dices"] = [] でも同じように動作するっぽい

    3. 上記のステップの3つ目

      こう書くなら、上のステップを数字付きの箇条書きにして「ステップ3まで」と書くとわかりやすい

    4. ここで、st.writeにいろんなデータ型を渡しただけのアプリを作って、それぞれいい感じに表示されるところをスクショでみせてほしい。

    5. それ相応

      それ相応、がどういうことを指しているのかがわかりにくい。

      相応だと思っているのは誰なのか、が気になる。

      「適切な」とか「データ型にあった」とかの表現でもよいのでは

    6. 以下のとおりです。

      いきなり結果になっているけど、初期状態とテキスト入力してボタンを押した状態の2パターンがほしい。

      (アニメgifだとうれしいなー

    7. # 入力ボックス

      コードがごちゃっとしているので、コメントは1行上につけつつ、大きく機能が分かれるところで空行とか入れた方が読みやすいと思います

    8. スペース区切りの文字列から一つの単語を選択する

      このタイトルと、コードで st.title() している内容が違う。

      どういう意図のタイトルなのか?

    9. サンプルアプリ(1

      (1)はわかりにくいので、名前を付けた方がいいと思います

      サンプル - ランダム選択アプリ

      とか

    10. 多くの依存パッケージがあり、pandasなども依存しており多くのパッケージがインストールされます。

      表現が冗長

      pandasなど多くの依存パッケージが一緒にインストールされます。

      とか

    11. venvについては

      4月の記事でも、今までの他の人の記事でもそこまで説明していないので、venvの説明はなくてもいいのでは

      https://terada-202410-streamlit.gihyo-python-monthly.pages.dev/2024/202404

    12. 複雑な処理を

      複雑な処理はサーバーサイドではしているけど、フロントはシンプルみたいなことを言いたいと思うんですが、伝わらないと思います。

    13. これらの

      これら、が連続していて読みにくいのと、ここでの「これら」は一つ前の「これら」と違うことを指している? 代名詞を使わずに具体的に書いた方が良いのではにか

    1. この時間

      この時間、がどの時間を指しているかちょっとわかりにくいなと思いました

      コーヒーブレイクの時間は、とかでもいいかも

    1. 「Pythonと相互運用可能な静的型付けプログラミング言語Erg」を

      リンク先にスライドとかもあるので、このページからスライドへのリンクとかも入れてほしい

    1. 主催メンバーを募集しています

      まだ募集開始していないので、これから募集がはじまると思います。

      みたいな文章がよいのでは

  7. Sep 2024
    1. タイムスタンプの指定

      これ、このタイムスタンプより新しいバージョンはインストールされないってことですよね?そのような説明があるとよいと思います。

    2. たくさんのコマンドがあります。とか、前の記事に比べるとホゲコマンドが増えてます。とかあるとうれしいなと思いました

    1. Bootstrapのテンプレー

      ここで段落が分かれているので、普通の文章で以下のように角のはどうでしょう。

      Bootstrapの〜〜について以下の内容を学びました。

      • Navbar static〜
    2. リモートサーバー上で管理コマンドを実行できるSSH(セキュア・ソケット・シェル)セッションを開始します。

      SSHセッションを開始してリモートサーバーで管理コマンドを実行します。

      の方が読みやすいかなと

    3. トライアルアカウント

      上の方で試用期間、トライアル期間の表記揺れもあったので、どっちかに統一してください。

    4. 「学習ノート」プロジェクトが依存するパッケージをリモートサーバーに知らせる必要があるので、

      直訳だと以下と思います(主語がリモーサーバー)

      リモートサーバーは「学習ノート」が依存するパッケージを知る必要があるので、

    5. <ul class="list-group border-bottom pb-2 mb-4"> (2) {% for topic in topics %} <li class="list-group-item border-0"> (3) <a href="{% url 'learning_logs:topic' topic.id %}"> {{ topic.text }}</a> </li> {% empty %} <li class="list-group-item border-0">トピックはまだ作成されていません。</li> (4) {% endfor %} </ul>

      【重要】強調する行がずれてます

    6. 閲覧者が

      明示できます。で文が終わるので「閲覧者に対して」の方がよいと思います。

      閲覧者が明示できます。だと主体が途中で変わっている

    7. ユーザーが

      一瞬「ユーザー」が主語に見えたので、英文に合わせて語順を変えてもいいかも。

      長めのメッセージを表示し、ユーザーが「学習ノート」でできることをより詳しく説明します。

      とか