-
Notifications
You must be signed in to change notification settings - Fork 152
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
「処理系」を「動作確認できた処理系」に変更したい #1274
Comments
これはそのまま「動作確認できた処理系」がフィットしそうです。
「対応していると期待できる処理系」でもいいですが別案をあえて出すなら「対応したと宣言されている処理系」とかはどうでしょうか。
MDNの互換性テーブルみたいなのが作れればいいんでしょうけどなかなか大変ですよね・・・。こういうのを運用するとしたらMDNがやっているように言語をまたいで英語版cppreference.com の著者たちとかと連絡を取ってやるみたいなそういう規模感の運営がないとやっていけなさそうです。 |
「動作確認できた処理系」というのは何だか執筆者視点の感じが強く出て読者的に見ると変な感じがします。「確認済み処理系」の方がニュートラルな感じがします (理由を聞かれたらあまり説明できないですが)。 そういえば「動作する」ということを確認した処理系しか載っていないんですね (動作しないことが確認されたものは載っていない)。だとすると載っていないものは動かないのかあるいは単に未確認なだけか分からないんですね。見出しは「処理系の対応状況」として
みたいな感じのほうがひと目に見て分かる気もします。 「対応したと宣言されている処理系」はもっと的を射た短い表現がありそうな気もしますが出てきません (カタログスペックというのも微妙に違うし)。 或いはこれも絵文字で示せたらいいのですが、一目で「対応したと宣言した」と分かる絵文字というのも難しそうです。Release "note" 的な連想で
とか、或いは対応したと主張している時点で⭕として、更に動作検証は "追加で verified された" 的な捉え方で
など。 確かに英語圏でこういう情報ってまとめていないんですかね。或いは各コンパイラ・標準ライブラリの開発者自身が todo リストとかチケットシステムみたいなものを管理していたらそれが一番確実な気もします。 |
いままでは、動作しないことが確認できた処理系も??にしていましたが、
みたいに書けると、たしかにうれしいですね。こう書けるなら、「動作確認できた」と書かなくてもよいと思います。「処理系の対応状況」でいいですね。 |
ありですね |
雛形として、リファレンスの全ページにチェックマークの読み方を記載すれば、これでいい気がしますね
|
処理系の対応状況(❌ = 未実装、⭕ = 実装済・未検証、✅ = cpprefjpで検証済)
こんな感じですか。 絵文字はこれまで cpprefjp の中で使われていましたか。絵文字はテキストブラウザや音声読み上げ対応でどうなるんでしょう。後ブラウザ間の絵文字の表示のぶれだとか。画像埋め込みにして代替テキスト ( それから絵文字を直接 |
絵文字はREADMEのCIバッジ以外では使ってないですね。 |
絵文字、コードブロック中のコメントですけど、使ったことがあります |
上のページでは UB, ok などの文字列と併記されているので絵文字が豆腐になっても大丈夫ですね。
うーん。やはり絵文字が表示できるときは絵文字だけの方が見やすく感じます。 調べてみたら |
私が使ってるMacVim環境でも、絵文字はカーソル位置がよくわからないことになったりしますね。
これでどうでしょう? |
|
良いと思います! 追加で 例: |
|
[mark xxx]は文脈問わず使えていいと思うので (文脈を限定する方が実装コストがかかる)、ほかの文脈で使う可能性を考慮して、impl / noimplのような意味を限定したものじゃないものにしてもいい気はします。 |
title が 未実装・実装済・検証済 なのでそのまま使い回すのは難しいかもしれないですね。title に合わせて [mark impl] / [mark noimpl] で良い気がしてきました。そうすると今度は [mark ok] で "検証済" とするのは #1274 (comment) by @onihusube における "ok" と意味がかちあうので、より具体的に [mark verified] とか [mark confirmed] とかの方が良いかもしれません。 |
それじゃverifiedにしましょうか。 |
手元ではsite_generatorとmarkdown_to_htmlの修正ができて動作確認もできたので、相対リンクのPRをマージしたらコミットしようと思います。 |
ページのメタ情報が動かなくなってしまったので、一旦差し戻します。 |
絵文字の機能は入りました。こちらで確認できます。 あとは、既存ページに絵文字を入れていくのと、編集者向けページを直します。 |
全ページのコンパイラバージョンに、絵文字をつけました。 ひとまずこれで完了です。問題ありましたらreopenしてください。 |
ライブラリリファレンスにある「### 処理系」の見出しは、実際に「動作確認できた処理系」を意味するのですが、そうであることがわかりにくいので、そうであるとわかるようにしたいです。
それと、「対応していると期待できる処理系」みたいなのを追加して、(試せる環境がないなどで) 動作確認はできていないけど、リリースノートを見ると対応してるように見える、というのを書ける場所を用意したい気がしています。
見出しタイトルが悩ましいので別案があればほしいです。
動作確認できた処理系の記載には、依然としてオーバーロードごと・バージョンごとをどうするかの問題が残ってはいますが、ひとまず曖昧さをなくす提案をしました。
The text was updated successfully, but these errors were encountered: