ここでは毎週共有に値するテクノロジー関連のコンテンツを記録し、金曜日に公開します。
この雑誌オープンソースで、の投稿を歓迎します。また、《誰が採用しているか》サービスがあり、プログラマーの求人情報を公開しています。協力のご依頼はメールでご連絡ください([email protected])。
表紙画像

昔日的「皇家庭園」北京頤和園の昆明湖は完全に凍り固まり、観光客が楽しむ大きな氷の広場になっています。夕日が沈み、湖上の十七孔橋は「金光りが穴を通り抜ける」光景を呈しています。(via)
技術文章の書くための第一の秘訣
技術文章は非常に重要で、製品の開発、宣伝、保守に必要です。

皆さんの想像とは異なりますが、技術文章の良し悪しは、文語レベルとはあまり関係なく、むしろ技術的なスキルの問題です。
なぜなら技術文章の評価基準は芸術性ではなく、表現がはっきりしているかどうかだからです。華麗な言葉や巧みな比喩、深い感悟は必要なく、問題をはっきりと伝えるだけです。
問題をはっきりと伝える鍵は、あなたの考えがはっきりしているかどうかにあります。

問題が明確になったら、いくつかの基本的なコツをマスターすれば、良い技術記事を書くことができます。
今日は、技術写作の最も重要なコツは何かについてお話しします。シンプルに言えば、一言でいうと:記事は単一の構造で書く。
「単一の構造」(または「線形構造」)とは、一つの記事が一つのことを述べ、線形の順序で展開し、浅からく深く、段階的に、平面的に、層を重ねて進めることを指します。
これはまるで観光地で、ただ一つのルートしかなく、入口から出口まで矢印をたどれば、すべての景観を見ることができ、非常に明確です。
もし複数のルートがあると、観光客は混乱し、どのルートを選べばいいのか、景観を逃さないのか分かりません。それに、ルートが交差していると、さらに悪いことに、観光客はルートを間違えてしまうかもしれません。

(写真の説明:上の観光地のルート図、どのルートを選べばいいですか?)
単一の構造を採用すれば、技術記事はあまり悪くない。内容が難解であっても、少なくとも構造は明確で、一つ一つつながっており、読者は自分がどこでつまずいているかを知ることができる。この難点を克服すれば、前進し続けることができ、迷路に迷わず、方向を失い、五里霧中に陥ることはない。
ある外国人の記事があり、記事の構造を図で示しており、非常に具体的であった。

上の図は単一の構造であり、矢印に従って段階的に進める。
ある問題は複雑で、複数の要因に関わる場合、星型構造になる可能性がある。

それとも「階層構造」かもしれない。

この場合、問題を複数の記事に分けて取り組むことをお勧めし、各記事は単一の構造を保ち、一つの記事で一点だけを述べ、それを徹底的に説明することを心がける。
しかし、単線構造は口で言うのが簡単だが、実際には難しい。難しいのは、人間の思考が単線的ではなく、複線的で、場合によっては非線形的だからだ。
混乱し、飛躍的な思考を単線構造に整理し、それを表現して他者に理解させるのは、容易なことではない。通常、繰り返し検討し、磨く必要がある。
例えば、私たちの思考は下の図のように、多くの点がそれぞれ放射状に広がり、互いに接続されているかもしれない。


このように乱れた思考自体は恐くないが、文章もそのような構造で書くのではなく、忍耐強く一つの線を整理する耐心がないと恐ろしい。
テクノロジー動向
1、倉庫ロボット
アマゾン社は倉庫で人間型ロボットのテストを開始した。

それは商品の拾い上げと運搬に使われ、1時間あたりの運用コストは10~12ドルである。将来大量に導入すれば、コストは2~3ドルに低下すると期待される。

それは労働者と一緒に働く(下図)。労働者はとても恐れており、このロボットが彼らを置き換えるのではないかと感じている。アマゾンは、ロボットは労働者を支援するだけで、後者を置き換えるわけではないと述べている。

あなたがロボットと一緒に仕事をし、同じようなことをするのに、それが給料を要求しないとしたら、大概誰も気分が良くはなさそうだ。
2、ハチのバーコード
科学者がハチを研究する際、各ハチの行動を追跡する必要があるが、どうやって一群のハチの中で誰が誰かを区別するのか?
科学者は素晴らしい方法を考え出した。各ハチに簡易的なQRコードを貼り付けることだ。

このQRコードの面積は2.1平方ミリメートル(すなわち辺長が1.5ミリメートル未満)で、重さは0.6ミリグラム、工蜂の重さの0.7%であり、2048匹のハチの情報を表示できる。
科学者は手動で各ハチにQRコードを貼り付け、合計1400匹を貼った。その後、高速カメラの下でこれらのQRコードを読み取ることで、各ハチの行動を区別できる。


蜂巣の中には同時に数千匹のハチがいる。画像を拡大すると、それぞれのハチの行動経路を描くことができ(下図)、何をしているか、誰と協力しているかを分析できる。

3、舌マウス
今年のラスベガス「消費電子博覧会」CESで、「舌マウス」が展示された。

これは歯輪でミニテクスチャーボードを上顎に固定し、手を使わず舌だけでマウスを操作する。
この機器の目的は、手の損傷や麻痺した人々がコンピューターを使いやすくすることだったが、後に健全な人々にも市場があることがわかり、機械士や外科医は両手を解放して他の作業をしながらコンピューターを操作できる。
4、盗難防止箱
欧米の小規模小売店、例えば雑貨店や小規模スーパーでは、商品を盗難防止箱に入れることがますます流行っている。

この透明なプラスチックの箱は、鍵で開ける必要があり、客は自分で商品を取り出せず、店員のみが開けることができます。

箱には RFID チップも内蔵されており、無断で店外に持ち出すとアラームが鳴ります。これにより、商品の損失や盗難が大幅に減少します。

記事
1、高德地図が赤信号カウントダウンをどのように実現するか?(中国語)

高德地図は赤信号カウントダウンの読み上げを表示します。本稿ではその背景にある特許について解説します。
2、2023年前端技術の回顧と展望(中国語)
腾讯云開発者公式公众号と腾讯 MoonWebTeam フロントエンドチームが共同制作した長編技術レポート。@ryantang1991 提出)
3、JS 空配列の every() メソッド(英語)

every() メソッドは空配列に対して常に true を返すのはなぜですか。
4、8つのオープンソースパスワードマネージャの紹介(英語)

パスワードマネージャは様々なログインパスワードを管理するために使用され、本稿では8つのオープンソースのパスワードマネージャを紹介します。
5、驚くべき CSS アニメーション効果(英語)

本稿では高度なCSSアニメーション技術をいくつか紹介します。
6、HTTP/3の詳細解説(英語)

一連の記事で、HTTP/3プロトコルの設計とHTTP/2との違いを初心者向けに解説しています。
7、CPUの製造過程を図解で解説(英語)

作者は多くの画像を使い、ストレートにCPUがどのように石から作られるかを解説しています。読んでみれば、CPUの製造プロセスについて概要を理解できます。
ツール

は作者がChatGPT Next Webのソースコードを修正し、Gemini Proに対応させました。ここにデモがあります。(@lchh5 投稿)

木鱼を叩くウェブアプリです。モバイル端末で開いた場合、携帯電話のジャイロスコープの角度変化が検知される場合にのみ、一度の叩き動作として認識されます。この時、携帯電話を木鱼を叩く棒として想像できます。(@jwenjian 投稿)
3、Moodist

オープンソースのDockerイメージファイルで、50種類以上の背景音楽を提供しています。例えば風の音、雨の音、カフェの音などです。(@geekyouth 投稿)
4、Echo UI

Web Audio API用に設計されたUIライブラリで、Webベースのオーディオアプリを構築するのに適しています。(@codeacme17 投稿)
5、Photor

スクリーンショット美化工具はオンラインで使用でき、ブラウザプラグインを通じても使用できます。(@sleepy-zone 投稿)

オープンソースのメッセージプッシュプラットフォームで、メール、DingTalk、WeComなどの通知方法を統合します。(@engigu 投稿)
7、Tiny RDM

Redisデスクトップ管理クライアントで、Mac、Windows、Linuxをサポートします。(@tiny-craft 投稿)
8、フリゲート

オープンソースのカメラファームウェア、リアルタイムのターゲット物体検知を備えています。

は、1枚の画像のみで顔を抽出し、パーソナライズされた画像合成に使用でき、さまざまなスタイルをサポートしています。Demoを試してみてください。(@zinc1234596 投稿)
10、HandBrake

は、ビデオエンコードを変換するためのクロスプラットフォームデスクトップアプリケーションです。
11、Animotion

ウェブページ用CSSアニメーション生成器、ビジュアルでアニメーション設定し、コードを自動生成します。
12、Ada

URL解析器、最新の規格に準拠し、C++で書かれており、URLを高速に処理できます。
13、Inpaint-web

オープンソースの画像修復と超解像度ツール、ブラウザ側だけで実装されています。(@lxfater 提載)
14、ポートレート生成ツール

手描風 SVG 人物イラストコレクション Open Peeps、オンラインで人物イラストをカスタマイズするツールです。(@zerosoul 提示)
リソース
1、唐庫学習

電子書籍サイト、世界の名作の中日英対訳朗読を提供。(@bigtang5 提示)

このサイトはAIで生成されたフォントをリストしており、オンラインでそれらを使ってテキストレンダリングができます。

また、ウェブページの手書き文字を8文字生成し、自分のAIフォントを作成することもサポートしています。(@qq345386817 投稿)

ユーザーはここで様々なクラウドネイティブアプリを閲覧し、Docker、Kubernetes、Rainbondなどの様々な実行環境に一発でインストールできます。国内のイメージアクセラレーションをサポートしています。(@RainBondsongyg 投稿)
4、 iHateRegex

は、一般的な正規表現を収集したリソースバンクで、視覚化によって理解を助け、regexper を基にしています。(@zkerhcy 提案)

は、中国の古詩詞を学び楽しめるウェブサイトです。(@meetqy 提案)
6、极简博客

は、作者が NextJS + Laf を使ってクラウドで構築したブログホスティングサイトで、サブドメインを無料で提供しています。@kingwrcy 提出者)
画像
これはアメリカサンフランシスコ市の歩道の一部で、2015年の様子です。

あるデザイナーがこの歩道を改造し、「都市の森」という景観を作り出すことを決意しました。
歩道は幅3.66メートルで、中央の半分を通行に残し、両側を緑化しました。

中央の部分を再舗装した後、彼は2016年に両側に植物を植えました。


2022年、この道はこんな風になりました。


これを見て、「木を植えるのに最適な時は10年前で、次に今」という有名な言葉を思い出しました。
要約
2010年の某日、私は電話を受けました。
顧客は内网に数つのサービス(dhcp、内部DNS、Apache + PHPサーバー、NFSとSambaファイルサーバー)をデプロイしたいと考えており、サーバーを設置する必要がありました。
私は顧客に企業級のハードウェアを購入することを提案しましたが、彼らは既存のサーバーを使用することを強く望みました。それはコンシューマー向けのコンピューターで、ダブル電源がなく、リモート管理機能もなく、ハードディスクもコンシューマー向けでした。
顧客は元々Windows 2008 Serverをインストールし、その上でこれらのサービスをデプロイする予定でした。2日しかないことを考慮し、私はNetBSDシステムのインストールに変更することを提案しました。顧客は同意しました。

インストールが完了した後、私はそれを顧客に引き渡しました。その後1ヶ月、ネットワーク遅延問題以外は、顧客からのフィードバックは基本的に肯定的でした。
その後数年間、私はこのサーバーをたまに調整しましたが、その後顧客と連絡を絶ちました。
2021年2月、私は再びその顧客から電話を受け、新しいファイアウォールを欲しがりました。これは、NetBSDサーバーがまだ稼働していることを意味しました!好奇心から、私はこの仕事を受けました。
驚いたことに、このサーバーは完全に正常に動作していました。外部ネットワークへのアクセスは提供しなくなりましたが、内部ネットワークでは順調に動作していました。NFS、SMB、DNS、SMTP すべて正常に動作し、約80%の元のタスクを実行しています。
最も驚いたのは、その正常稼働時間でした。最後の再起動は2012年で、その時小さな地震が発生しました。顧客には予備の発電機があるため、サーバーは常に不間断の電源を供給されています。
想像もつかないことに、このマシンは当初数時間でインストールされ、すべてがコンシューマーハードウェアで、9年間再起動せずに正常に稼働し、その間ほぼ管理されていませんでした。
私は今、なぜ私は----そして永遠に----富を得られないのか理解しました。以前の上司は、私が顧客に安定して信頼できる解決策を推奨することを好むと不満を言いました。これは、長期的な利益が少ないことを意味します。彼によると、頻繁なメンテナンスが必要な信頼できない解決策こそが、最も多くの収入をもたらすと言います。しかし、私は優れた仕事は継続的に効果的であるべきで、絶えず修正する必要がないと感じます。
今、このサーバーがまだ動いているかどうか分かりませんが、機会があれば必ず確認します。NetBSDに感謝しています。信頼に値し、軽量で安定し、安全で効率的なオペレーティングシステムです。私の見解では、今でもその価値が十分に認められていないと思います。
発言
1、
AIチャットロボットはすぐに非常に強力になり、神のように見えるようになり、将来、AIを崇拝する教派が現れるかもしれません。
2、
莫大な負債を背負って学業を完成させた学生は、あまり大きな理想を持たないかもしれません。なぜなら、人々が負債に陥ると、他のことを考える時間がありませんから。
負債は改造の手段であり、これらの学生が卒業したとき、彼らは重い負債を背負うだけでなく、思想も改造されており、消費経済の有効な構成要素になるようにされています。
-- ノーム・チョムスキー、アメリカの著名な学者
3、
1931年、オーストリアの論理学者クルト・ゲーデルは重要な「ゲーデル不完全定理」を提唱しました。彼は、どの数学的公理の集合も完璧であることはあり得ず、いくつかの事実はこれらの公理で証明できないことを証明しました。同時に、彼は、矛盾を引き起こすことなく一貫性を持つ公理の集合が存在しないことも証明しました。
これは、どの理論体系も証明できない命題が常に存在することを意味します。あるいは、あなたが何を証明できるかは、あなたの初期仮説によって決まり、そしてこれらの仮説は証明できません。
4、
会社にはどれだけ多くのエンジニアが必要か?これはソフトウェアの機能の数に関連していますが、ソフトウェアのユーザーの数に関連しません。
ソフトウェアにさらに多くの機能を追加する必要がある場合、より多くのエンジニアが必要です。ソフトウェアの機能が単純であっても、規模が大きく、数億のユーザーがいる場合、実際には多くのエンジニアは必要ありません。
過去の振り返り
中国の成長の原動力は内陸(2023 #241)
プログラマーの財政的独立への道(2022 #191)
閉じたシステムの勝利(2021 #141)
インド・ムンバイの住宅地価、なぜ北京と同じように高い?(2020 #91)
(終)












