Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

GET/POST の章を大きく変更する #816

Open
aster-void opened this issue Sep 13, 2024 · 2 comments · Fixed by #835
Open

GET/POST の章を大きく変更する #816

aster-void opened this issue Sep 13, 2024 · 2 comments · Fixed by #835
Assignees

Comments

@aster-void
Copy link
Contributor

頑張る。

@aster-void aster-void self-assigned this Sep 13, 2024
@aster-void
Copy link
Contributor Author

aster-void commented Sep 27, 2024

各差分の変更理由:

  • タイトルを「HTTP リクエストメソッド」に変更する
  • 他の章と合わせるため。
  • 見出しを「リクエストの種類」に変更する
    • 同様。
  • HTTP メソッド → リクエストメソッド に変更する
    • 理由: MDN に 「HTTP メソッド」という記述はないため。
    • 「HTTP リクエストメソッド」「リクエストメソッド」「HTTPメソッド」「メソッド」の4択。
      • RFC は 2.、 MDN は 1. と 2.。
    • 結論 → タイトル: HTTP リクエストメソッド / 地の文: HTTP リクエストのメソッド (メソッドがstrong)
  • app.getapp.post などのあとの (express.Application#method) を消す。
    • 理由: おいておくことのメリットより読みにくさが大きいため。
    • 案1 Express の get メソッドでは、HTTP の GET メソッドのリクエストしか受け付けられないため、、、、
    • 案2 Express の get メソッドでは、GET リクエストしか受け付けられないため、、、、 << これで行く。
      • GET リクエスト = メソッドが GET のリクエスト、という話をどこかに導入しておく。
        • 最初の方から単語は導入されてるため、それの説明を入れる感じ。
  • 表現の修正
    • before: クエリパラメータにアクセスするには、request.query を使用しましたが、リクエストボディを使用するには、request.body を使用します。
    • after: クエリパラメータには、request.query からアクセスできましたが、リクエストボディにはrequest.bodyからアクセスできます。
    • 理由: 冗長なのと、「使用する」は取れる意味が多すぎるため。
  • スクショ3連打を消す
    • 理由: スクショがあるメリットより読みにくさが大きいため。
    • 変更先: 入力後・送信後の 2 枚と図による説明。

第二章

  • 見出しの命名変更: 「POST リクエストを開発者ツールで覗いてみる」 → 「ブラウザの通信を覗いてみる」
    • 理由: POST リクエストに限定する必要がないため。
  • 動画を取り直す
    • [ドキュメントガイドライン (ut.code(); Learn)](https://www.notion.so/ut-code-Learn-e9c7322029854766af4a950f5f114d65?pvs=21)
    • 理由: ブラウザのブックマークが余計な情報
    • 拡大などを駆使して必要なものだけがうまく表示されるようにする
    • 動画の撮影範囲に気をつける
    • 4Kモニターを使うらしい。(もしくは拡大率を変更して解像度を上げる)
    • 動画を圧縮する
    • ダークモードオフ
    • 基本は数百KB以内にまで圧縮する。長いのでも1MBまで。
      • ffmpeg で圧縮しよう。オプションを頑張っていじれば結構圧縮できるらしい。
        • crf というオプション?
    • それより長かったら YouTube 行き

@chvmvd
Copy link
Contributor

chvmvd commented Sep 29, 2024

上の説明では、口頭で話し合った人以外には理解することが難しいので、もう少し詳しく説明していただいても良いでしょうか。また、「タイトルをHTTPリクエストメソッドに変更する」など結論のみでどのような経緯でそのような結論になったのかがわからないものもあるのでその説明も書いていただけるとありがたいです。また、このIssueの内容とは関係のない内容も多いので、それも精査していただけるとありがたいです。

@chvmvd chvmvd reopened this Sep 30, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants