Shinnosuke Yamamoto mrtry

name

japanese-tech-writing

description

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

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

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

整形

LLM Wiki

A pattern for building personal knowledge bases using LLMs.

This is an idea file, it is designed to be copy pasted to your own LLM Agent (e.g. OpenAI Codex, Claude Code, OpenCode / Pi, or etc.). Its goal is to communicate the high level idea, but your agent will build out the specifics in collaboration with you.

The core idea

Most people's experience with LLMs and documents looks like RAG: you upload a collection of files, the LLM retrieves relevant chunks at query time, and generates an answer. This works, but the LLM is rediscovering knowledge from scratch on every question. There's no accumulation. Ask a subtle question that requires synthesizing five documents, and the LLM has to find and piece together the relevant fragments every time. Nothing is built up. NotebookLM, ChatGPT file uploads, and most RAG systems work this way.

これは私が支援先に提供した、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):