Notices by 7of9(0x70f9=28921) (7of9@qiitadon.com), page 81

1カ月前から時間を見つけて読み続けた一つのソースコード。

34件のesa.io記事を作成。

将来の時間節約できそうなので、ここで終了。

次のソースコード読みに移る。

#search
#coding
#sourceReading
#tool

- 検索した時、無関係のものが出てくる (変数名、関数名)

「なぜ、検索しにくい変数名、関数名にしているのだろうか?」というのが僕の疑問。

答え：検索をそれほどしていない。

思い出したのは
- スクロールバーで移動しながらソースを読んでいる
- grep検索のような機能を使っていない (少なくとも目の前では)

記憶力が良いのかもしれない。
記憶に基づいて、見たい実装を開いているのかもしれない。

ソースの可読性、検索性が良くならない一つの例として。

#sourceReading
#coding

.cファイルを見ただけではエントリポイントがよく分からない。

関数宣言の.hファイルをまとめて定義している場合もさらに分からない。

2つのエントリポイントが用意されている場合は、下記の情報があるとソースを読みやすくなる。

A. どれとどれがエントリポイントか
B. それぞれがどういう用途で使われるのか

他の詳細についてはエントリポイントから掘り下げていけばよい。

> https://www.linuxfoundation.jp/resources/open-source-guides/starting-open-source-project/
> 企業内でOSSプロジェクトを立ち
> 上げるガイドラインがLFから出
> ていて、それが日本語訳されてい
> る。これはかなり良い。

:twitter: https://twitter.com/mhiramat/status/1039750842457436162

訂正Toot
----
#chinese

今日のYouTubeリピート
为什么没照上呢
Wèishéme méi zhàoshàng ne (なぜ写真がとれないのですか。 @ 中国語301句)

?

今日の昼。持参した肉じゃがのみ。じゃがいも、ニンジン、玉ねぎ、豚肉(牛肉でなく)。

普段はおにぎりとサラダ程度なので、量的には同じくらい。

材料費と作るコストを考えると１００円くらい安くなるかどうか程度。

ただ、おにぎり＋サラダは選択肢が少なく飽き、他のものにすると価格が上がる。

買っておいて持ってくる、パターンを増やせばいい気もする。

#chinese

今日のYouTubeリピート
为社么没照上呢
Wèishème méi zhàoshàng ne (なぜ写真がとれないのですか。 @ 中国語301句)

@manzyun さんとのQiitadon上でのやりとりで色々アイデアいただいている人がここに。

特定タグに備忘録を書くこともしたが、新規記事作成時に探すのが面倒で、Templatesを使った方が作業の動線がすっきりする。

#esa.io
#documentation
#templates

-----
Templates:

esa.ioにはTemplates/という機能がある。

Templates/は記事作成時に選択することで、タイトルの形式を統一するためにある。

ただし、カテゴリを変更したい時に手入力となるので、自分はあまり使わない。

-----
Templatesを備忘録に:

記事を作成する上で特定の形式で書きたい時がある(例: 「XXXの処理 > YYYのとき、ZZZに基づきAAAする」)。しかしながら、その形式を「どうだったけ?」と忘れる。

そこで、備忘録的にTemplatesを使う。
Teamplatesに「XXXの処理 > YYYのとき、ZZZに基づきAAAする」を作る。
新規記事作成時にSelect Templateのコンボボックスで作成したテンプレートの「書き方」を参照する。

そして、記事を書く。

#MastoOwn

今日も自分のToot探すのにMastoOwnが役立ちました。

@hidao
ありがとうございます。

#esa.io
#search
#difference

A. title:の処理
B. title:"の処理"

Aにおいては「の」と「処理」が分離され検索される。あいまい検索や間違ったキーワード検索時に関連性のある記事を見つけやすくする対処。

Bにおいては「の処理」が検索される。

----
Aについては違和感があったが、説明を受けると「それがある方が良い」と感じた。

google検索とも似ている。

@blhsrwznrghfzpr

ありがとうございます。

今後こういうデザインとなるようでしたら、このままといたします（バグがない限りですが）。

個人的には直線的なデザインが好きなのです。シャッキとしています。

#UI
#chrome

Chromeのタブの形がおかしくなった。
角丸になっている。
前の方が良かったと思う。

バージョン: 69.0.3497.92（Official Build） （64 ビット）
+ Windows 8.1 Pro。

#naming
#documentation
#esa.io
#search

https://qiitadon.com/web/statuses/100590946985987290

の再検討。

実際にesa.io記事(10,528件)から検索時、下記のような記載だと検索できそうだ。

「XXX()の処理 > YYYしてZZZする」

検索キーワードは「title:"()の処理"」

esa.ioの検索の癖もあるためダブルクォーテーションが必要。

----
ドキュメントの記載形式を統一化することで閲覧性、検索性が上がる。
形式の統一化にはesa.ioのTemplates/を使う。

単に処理を同期にするか非同期にするかだと、その処理自体の成功失敗は普通は変わらないけど、組み合わせにする(処理順序を保証しようとする)と途端に難しくなる
分散系も本質的には同じような感じかなあ

#communication
#async

物の受け渡しは同期処理。

非同期処理（不在時に置いておく、メモなしで）をして失敗する例は見ます。

非同期処理(不在時にメモとともに置く）よりは同期処理だと失敗が少ないと考えています。