記事やソースコードを公開するときに気をつけていること - テックブログガイドライン

記事を書いてみよう！という人に、楽しく書くために！
こういうことに気をつけようを説明するために書いたもの。


## 1. 規約、ガイドライン

[Qiita - コミュニティガイドライン - Qiita:Support](https://help.qiita.com/ja/articles/qiita-community-guideline)
[Zenn - Modern Knowledge Base for Developers](https://zenn.dev/about)
[note ご利用規約](https://note.com/terms)

記事をどこに書くべきか、何を書くべきか、どう書くべきか、の問題
引用：[ブログに書くか、Qiitaに書くか（技術系のネタを）](https://blog.jnito.com/entry/2018/03/23/093539)
>上の観点で一番重要なのは「自分の庭」vs「みんなの公園」という考え方かもしれません。
Qiitaは「みんなの公園」なので、ルールやマナーに従ってみんなが気持ちよく使えるようにしなければなりません。Qiitaのルールやマナーについては以下のページに詳しく書いてあります。最低限、ここに書いてあるガイドラインは守るべきです。

- Qiitaは技術が主語の技術記事
- Zennは「人が主語の技術記事とアイディアノート」も許容する場合もある
- noteは「クリエイター」の発表の場


### Qiitaがふさわしい

> - 技術系オンリー 
> - コードの割合が多い技術ネタ
> - Qiitaは「みんなの公園」で、主役は技術
    - (引用：[ブログに書くか、Qiitaに書くか（技術系のネタを）](https://blog.jnito.com/entry/2018/03/23/093539))

- つまり、いわゆるテクニカルライティング的文章

#### Qiitaコミュニティガイドライン詳細
- プログラミングに関する再利用性・汎用性の高い情報が集まる場をつくろう
- 「プログラマーが興味を持つものではなく、プログラミングに関する記事を投稿しましょう。」、この表現は結構難しい。

#### ソースコードの割合が多ければわかりやすいが以下例はどうか
- ソースコードの読み方
- レビューの仕方
- チームビルディング
- 読書記録
- 動画の視聴記録
- イベントの開催報告

よりどころとすべきは、どこまで自分がこのガイドラインを「誠実」に考えて記事を書いたか、説明できるかになってくる。


#### 「[コミュニティガイドライン](https://help.qiita.com/ja/articles/qiita-community-guideline)」

> エンジニアにとって再利用性・汎用性の高い情報が集まる場をつくろう
> 「あなた」と「誰か」がつながる場としていこう
> エンジニアとしてのアイデンティティを確立し、表現していこう
> Qiitaでの「エンジニア」の定義
> Qiitaを利用するにあたってのマナー

> Qiitaを利用する際には「HRT」を大切にしよう
> ☝ エンジニアにとって再利用性・汎用性の高い記事を書こう
> ☝ 読み手にとって適切な表現を心がけよう
> ☝みんなが読んでも理解できる記事を書こう
> ☝ 参考にした記事は参考文献として記載しよう
> ☝ 記事の価値はみんなで高めよう

[Qiitaで記事を公開するときに気を付けるべきマナーについて 〜無断でネットや書籍の内容を丸写しするのはやめよう〜](https://qiita.com/jnchito/items/215c2d51599eb29adabc) も一読。

### 個人ブログがふさわしい

> - まったく技術系でない話（子育ての話とか音楽の話とか）
> - 技術系だけどコードの割合が少ない話
> - ブログは「自分の庭」なので、主役は自分自身
> - PV（閲覧数）の面では若干不利（めちゃくちゃ有名なブロガーでない限り）
    - (引用：[ブログに書くか、Qiitaに書くか（技術系のネタを）](https://blog.jnito.com/entry/2018/03/23/093539))

- つまり、いわゆるクリエイティブライティング的文章

### まよったら
- [Qiitaのいろいろランキング2020](https://qiita.com/rana_kualu/items/307d461ad2d59a1d6008) 等、いい記事とは何なのかを見る。
- [Difference between Technical Writing and Creative Writing](https://www.geeksforgeeks.org/difference-between-technical-writing-and-creative-writing/)
- 事実を書いているか、意見を書いているか、というところで自己批判してみる。
- 「ポエム論」は、たびたび議論になっているようだ。また別の記事で書く。





## 2. GitHub規約、注意点

https://docs.github.com/ja/github
https://www.csaj.jp/documents/NEWS/pr/210202_Github.pdf

### Fork
[fork する意味](https://yasulab.tumblr.com/post/11856357434/fork-%E3%81%99%E3%82%8B%E6%84%8F%E5%91%B3-github-%E3%81%AB%E3%81%AF-fork-%E3%81%A8%E3%81%84%E3%81%86%E6%A9%9F%E8%83%BD%E3%81%8C%E3%81%82%E3%82%8Bfork-%E3%81%AF-git)
> 貢献を意図していないにもかかわらず、オリジナル・リポジトリを fork した場合、オリジナルの開発者に貢献の意思があると誤解されることがある。注意が必要だ。

[リポジトリが削除されたり可視性が変更されたりするとフォークはどうなりますか？](https://docs.github.com/ja/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility)

> パブリックリポジトリをプライベートリポジトリに変更する
パブリックリポジトリを非公開にすると、そのパブリックフォークは新しいネットワークに分割されます。 パブリックリポジトリの削除と同様に、既存のパブリックフォークの 1 つが新しい親リポジトリとして選択され、他のすべてのリポジトリはこの新しい親から分岐されます。 後続のプルリクエストは、この新しい親に行きます。

> 言い換えれば、パブリックリポジトリのフォークは、親リポジトリが非公開にされた後も、独自の別のリポジトリネットワークで公開されたままになります。 これにより、フォークオーナーは作業を中断せずに作業を継続できます。 このようにパブリックフォークが別のネットワークに移動されなかった場合、それらのフォークのオーナーは適切なアクセス許可を取得してプルする必要があります。 以前はこれらのアクセス権が必要ではなかったとしても、(現在はプライベートになっている) 親リポジトリからの変更を取得して送信します。



## 3. 法務知識 - ライセンス・著作権

[著作権に気をつける](https://help.qiita.com/ja/articles/qiita-article-guideline#%E8%91%97%E4%BD%9C%E6%A8%A9%E3%81%AB%E6%B0%97%E3%82%92%E3%81%A4%E3%81%91%E3%82%8B)
[著書や人のブログにまつわる記事を書くと著作権違反になる？](https://help.qiita.com/ja/articles/qiita-copyright)
[ライセンスをつけないとどうなるの？ (Github)](https://qiita.com/Tatamo/items/ae7bf4878abcf0584291)
[「Log4j」の脆弱性を突く攻撃手段の情報共有は違法？　日本ハッカー協会に聞いた - ITmedia NEWS](https://www.itmedia.co.jp/news/articles/2112/13/news163.html)


### 翻訳
[記事作成に翻訳ツールを利用する際の注意](https://help.qiita.com/ja/articles/about-using-translation-tool)
海外サイトの無断翻訳時に想定されるトラブル
https://www.joho-translation.com/topic_englishtranslation_162.html
を考えたときに、ご本人の許可を尋ねるならこのような感じ。

```md
Hello!
I find your article very interesting.
Could I translate it into Japanese and post it on Qiita (https://qiita.com/(My ID or someURL))?
It is one of the most popular platform for Japanese developers (over 7 million users per month).
I will link to your article/profile page too.
``` 


### 本の要約
[本の要約](https://b.hatena.ne.jp/entry/s/qiita.com/ryosuk/items/08f14a57e071b362a8a0)

### ソースコード
[「よいサンプルコード」ってどんなサンプルコード？ 〜Qiitaや技術ブログを書くときに気を付けること〜 - Qiita](https://qiita.com/jnchito/items/da33f793de2e29e470f4)


### 素材

https://qiita.com/e99h2121/items/629bcae7225fe02c187a

[【2020年版】パブリックドメインで無料！世界の名画550万枚をダウンロードできる美術館サイト19個まとめ - PhotoshopVIP](https://photoshopvip.net/111868)
[これが無料？優秀なフリーイラスト素材サイト30（商用利用可）](https://saruwakakun.com/design/tips/illust)
[2.400万点以上の高品質なフリー画像素材 - Pixabay](https://pixabay.com/ja/)
[Beautiful Free Images & Pictures | Unsplash](https://unsplash.com/)
[Artvee](https://artvee.com/)
[商用可・フリーイラスト素材｜ソコスト](https://soco-st.com/)

その他 [スライドに使用可能な素材等と同様](https://qiita.com/e99h2121/items/79db6b7375ccbf3d3977)
[Wikipediaの画像を二次使用＆引用する方法](https://zbnr-hp.com/wikipedia-image) → ものにより気をつけること
[ジブリのフリー素材、商用利用は？ | これって違法？〜ブログ・SNS著作権解説〜](https://www.memoriba.com/2020/09/19/ghibli/) → 商用はよろしくなさそう


### テストデータ

[人物画像](https://www.photo-ac.com/main/search?q=&qt=&qid=&creator=acworks&ngcreator=&nq=&c_names%5B0%5D=1&nc_names%5B0%5D=3&nc_names%5B1%5D=4&nc_names%5B2%5D=5&nc_names%5B3%5D=6&nc_names%5B4%5D=7&nc_names%5B5%5D=8&nc_names%5B6%5D=9&nc_names%5B7%5D=10&nc_names%5B8%5D=11&nc_names%5B9%5D=12&nc_names%5B10%5D=13&nc_names%5B11%5D=14&nc_names%5B12%5D=15&nc_names%5B13%5D=16&nc_names%5B14%5D=18&nc_names%5B15%5D=19&nc_names%5B16%5D=20&nc_names%5B17%5D=22&nc_names%5B18%5D=23&srt=dlrank&orientation=all&sizesec=all&mdlrlrsec=on&sl=en&pp=70&p=1&pt=B)
[思わぬ事故防止！開発時やテスト時に使用するメアドのドメインは example.com に統一しよう - Qiita](https://qiita.com/jnchito/items/198a2561a36c2c2ef5e3)



## 4. 広報知識 - 宣伝行為

宣伝行為、記事の線引きなど、[コミュニティガイドラインについての補足説明](https://blog.qiita.com/160967008724-2/)
最近は以下も歓迎してくださっている

https://twitter.com/xrxoxcxox/status/1461645573375676420?t=TDYUs0S01hSBktJeXdm-Fw&s=19

### 対策

[広報が知っておきたい、企業の炎上対策・炎上時の対応方法について徹底解説【危機管理広報】 | PR TIMES MAGAZINE](https://prtimes.jp/magazine/prepare-for-the-flaming/)
[ＮＨＫ放送ガイドライン（インターネットガイドライン統合版）｜経営に関する情報｜NHKについて](https://www.nhk.or.jp/info/pr/bc-guideline/)


## 5. その他話題の、開発が知っておくと良い知識


### スクレイピング

[Webスクレイピングの注意事項一覧](https://qiita.com/nezuq/items/c5e827e1827e7cb29011)

### 公開APIの規約例

公開APIの規約
https://cl.asahi.com/api_data/term_api.html

https://a3rt.recruit-tech.co.jp/policy/terms.html

[長文要約生成APIを利用する前に気をつけたいこと](https://qiita.com/autotaker1984/items/523edf4fdc80a835028c)

### その他テキストコピペ系Webサービス

[DeepL翻訳をはじめとしたテキストコピペ系Webサービスは機密情報の扱いに注意しよう](https://qiita.com/jnchito/items/5667091e00cdf38d299a)

## 6. 話題の選び方

[君たちに問う！君たちはプログラマか！！](https://qiita.com/sh1ma/items/c5ddaa593d2c2c560d2c#comment-fb002bcf04e48b23fa71)
[ここ2ヶ月の｢Qiita｣と｢アウトプット｣についての議論まとめ](https://qiita.com/suin/items/a9d5c347feffa97458b1)

### でも書くとよい理由

[拝啓 本当は Qiita を書きたいのに、まだ迷っているあなたへ。](https://qiita.com/YumaInaura/items/4d2c602d59c62daa9344)
[Qiitaの記事には絶対コメントを書いてはいけない (わけがない)](https://qiita.com/YumaInaura/items/5532cb4eea013b2f4a4b)
[技術記事の3類型: 初心者による技術記事執筆のすすめ](https://zenn.dev/uhyo/articles/technical-articles)
[技術記事を書く人を大事にしよう](https://zenn.dev/kaityo256/articles/save_the_earth)
[「SNS疲れ」と「発信」、「アウトプット」の線引き](https://zenn.dev/e99h2121/articles/f4b9d53a59318b)


https://zenn.dev/terrierscript/articles/2018-04-25-masakari-yoke

https://zenn.dev/yohhoy/articles/backstage-of-tech-article

https://rentwi.hyuki.net/?1328423809787990018


随時追記　楽しく書くために。
以上、参考になればさいわいです。