Shinnosuke Yamamoto mrtry

name

japanese-tech-writing

description

日本語の技術文書・書籍原稿の文章規範。整形（一文一行、引用ブロック、脚注、コラム記法）、段落と論証の構成（パラグラフライティング）、論証の厳密さ（ツッコミどころの除去）、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。

日本語技術文書の文章規範

日本語で技術的な原稿（書籍の章、記事、解説文）を書く・推敲するときは、以下の規範に従う。

整形

これは私が支援先に提供した、1 on 1 に関するノウハウや、思いを述べたドキュメントを元にしています。企業の枠を超えて共有したいことが多いので、ここに貼ります。

概要

世の中には 1 on 1 の本があるようですが、とりあえずは『1 on 1 で何を話すのか？マネージャ/ソフトウェアエンジニアの立場から - サンフランシスコではたらくソフトウェアエンジニア』を読んでもらえればよいと思います (higepon さんに感謝!)。
1 on 1 は 1 対 1 で話すミーティングで、基本定期的にやります。上長とメンバーとの間で行うのが基本です。
グループ/チームでのミーティングを補完するためのものです。
- みんなの前では話しづらい、込み入った内容を話します。
- チームとして行っているタスクの進捗確認に 1 on 1 を使うのは避けましょう。それは 1 on 1 の目的に沿っていません。
基本、「メンバーの時間」と捉えてください。メンバーが話したいこと、上長に質問したいこと、相談したいことを話す時間です。
ですので、上長は相手の話をさえぎらず、聞くことに徹してください (話すのが得意な人、好きな人がマネージャになっている可能性が高いというバイアスに注意しましょうｗ)。

非破壊 TypeSctript

mizchi / TypeScript Meetup 2

About

mizchi / 竹馬光太郎
フロントエンドと Node.js

最新のステータス: 追記: 2019/7/10

転職しました。長らくのご愛顧誠にありがとうございました。

転職先をちょくちょく探しています。

興味ある方は twitter @mizchi へのリプライorDM、または mizchi2w@gmail.com まで。

📝 企業を調べる時のメモ書きです。

求人サイト

https://www.wantedly.com/
https://jobs.forkwell.com/
https://jp.indeed.com/
- 日本だとあんまり使ってる企業がいないけど、グローバルよりで日本でもやってる面白いものがたまに見つかる
などの各種求人サイトを見る
Note: 📝

We use git-secret to encrypt/decrypt sensitive information like production passwords.

GPG keys

Each developper needs to generate a pair of private/public key.

https://help.github.com/articles/generating-a-new-gpg-key/

gpg --full-generate-key

Electron apps

Slide deck frameworks supporting Markdown source

	// Created by react-native-create-bridge

	// import RCTBridgeModule
	#if __has_include(<React/RCTBridgeModule.h>)
	#import <React/RCTBridgeModule.h>
	#elif __has_include(“RCTBridgeModule.h”)
	#import “RCTBridgeModule.h”
	#else
	#import “React/RCTBridgeModule.h” // Required when used as a Pod in a Swift project
	#endif

	# -- coding: utf-8 --
	import commands
	import glob
	import os
	import xml.etree.ElementTree as ElementTree


	# http://stackoverflow.com/questions/33573807/faithfully-preserve-comments-in-parsed-xml-python-2-7
	class CommentedTreeBuilder(ElementTree.TreeBuilder):
	def __init__(self, args, *kwargs):