6
4

Qiitaに記事を書くときに注意していること

<この項は書きかけです。順次追記します。>

1 ソースコードを示す

多い場合は一部を記述し、全体はURLを示す。

プログラムちょい替え(0)一覧:4件
https://qiita.com/kaizen_nagoya/items/296d87ef4bfd516bc394

C++ Support(0) 
https://qiita.com/kaizen_nagoya/items/8720d26f762369a80514

Coding Rules(0) C Secure , MISRA and so on
https://qiita.com/kaizen_nagoya/items/400725644a8a0e90fbb0

2 コマンドを示す。

導入方法、実行方法、エラー記録方法など。

docker(0) 資料集
https://qiita.com/kaizen_nagoya/items/45699eefd62677f69c1d

なぜdockerで機械学習するか 書籍・ソース一覧作成中 (目標100)
https://qiita.com/kaizen_nagoya/items/ddd12477544bf5ba85e2

3 エラーメッセージを示す

できれば全体を記録する。
エラーが多すぎる時は、エラーのファイルを保存しているURLを示す。

Error一覧(C/C++, python, bash...) Error(0)
https://qiita.com/kaizen_nagoya/items/48b6cbc8d68eae2c42b8

4 Qiitaの記事を参考文献に示す。

同じような記事との違いを明確にできる。

アセンブラへの道
https://qiita.com/kaizen_nagoya/items/46f2333c2647b0e692b2

量子コンピュータプログラムへの道
https://qiita.com/kaizen_nagoya/items/37c90488c87bbe9f2d71

5 書籍、論文、規格、特許を参考文献に示す。

参考文献駆動執筆(references driven writing)・デンソークリエイト編
https://qiita.com/kaizen_nagoya/items/b27b3f58b8bf265a5cd1

参考文献の参考文献
https://qiita.com/kaizen_nagoya/items/093fa43ed9595190b961

5.1 一覧を示す。

Qiita(0)Qiita関連記事一覧(自分)
https://qiita.com/kaizen_nagoya/items/58db5fbf036b28e9dfa6

5.5 Wikiを利用したら、リンク切れを直し、Wikiに参考文献等を追記してくる。

日本語のwikiで、わからないから削除するという行動をとる人がいるらしい。削除する時は必ず削除する根拠のついた文献を一つ追加することを推奨する。なぜ日本語のWiki項目が13位と低いかは、削除する人が多すぎるからかも。削除するのではなく訂正すればいい。
https://ja.wikipedia.org/wiki/Wikipedia:全言語版の統計

6 専門用語・略号

略号にはなるべくfull spellをつける。
専門用語は英語を併記する。

7 外来語

外来語はなるべく原語を表記し、語源にあたり解説する。
カタカナ語は避ける。
英語のまま表記すれば意味がわかっても、
カタカナ語すると意味があいまいになる言葉がある。

英単語3つ連続でカタカナにすると文字列が長くなり、意味を取るのに時間がかかるかもしれない。

例:ソフトウェアライフサイクルプロセス
software lifecycle process
算譜輪廻過程

なぜ計画者(programmer)はカタカナ語を使わない方がよいのか 日本語(22)
https://qiita.com/kaizen_nagoya/items/d09e5ee549c4d9a17912

カタカナ語で選手権 日本語(17)
https://qiita.com/kaizen_nagoya/items/f1c0384a13dd13c5e7f1

参考文献(reference)

プログラマが知っていると良い「公序良俗」官(4)
https://qiita.com/kaizen_nagoya/items/9fe7c0dfac2fbd77a945

プログラマが心がけるとよい文章の書き方
https://qiita.com/kaizen_nagoya/items/af1e6207ccaa063dafb8

Qiita(0)Qiita関連記事一覧(自分)
https://qiita.com/kaizen_nagoya/items/58db5fbf036b28e9dfa6

日本語(0)一欄
https://qiita.com/kaizen_nagoya/items/7498dcfa3a9ba7fd1e68

英語(0) 一覧
https://qiita.com/kaizen_nagoya/items/680e3f5cbf9430486c7d

物理記事 上位100
https://qiita.com/kaizen_nagoya/items/66e90fe31fbe3facc6ff

自動車 記事 100
https://qiita.com/kaizen_nagoya/items/f7f0b9ab36569ad409c5

言語・文学記事 100
https://qiita.com/kaizen_nagoya/items/42d58d5ef7fb53c407d6

医工連携関連記事 100
https://qiita.com/kaizen_nagoya/items/6ab51c12ba51bc260a82

通信記事100
https://qiita.com/kaizen_nagoya/items/1d67de5e1cd207b05ef7

一覧の一覧( The directory of directories of mine.) Qiita(100)
https://qiita.com/kaizen_nagoya/items/7eb0e006543886138f39

<この記事は個人の過去の経験に基づく個人の感想です。現在所属する組織、業務とは関係がありません。>

文書履歴(document history)

ver. 0.01 初稿 20181127 朝
ver. 0.02 6,7 追記。2項目を詳細化 20181127 夕
ver. 0.03 見出しを簡明にし内容追記 20181128
ver. 0.04 参考文献追記 20181218
ver. 0.05 ありがとう追記   20230529

最後までおよみいただきありがとうございました。

いいね 💚、フォローをお願いします。

Thank you very much for reading to the last sentence.

Please press the like icon 💚 and follow me for your happy life.

6
4
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
6
4