ドキュメント

今回はAPIのデザインガイドラインのConventionsについてまとめようと思います 前回の命名についてのまとめは↓↓下記みてください！！ kumaskun.hatenablog.com 英語も個人的にわかりにくく計算量など聞きなれない用語も出てきていたのでまとめます Conventionsは慣例や規則・規約と訳すのかなと思っているのですが、あまりしっくりきていません。いい訳があれば教えて欲しいです！！ 計算量について 最初にO(1)ではないcomputed propertyには、計算量などの説明をコメント化するべきと記載されています ここで、O(1)や計算量など馴染みのない言葉が出てきます…

このブログで技術ドキュメントも書こうと思った。 あわせてよみたい このブログで技術ドキュメントも書こうと思った。 2023年はさ、なんか個人開発でアプリとかwebサービスとかを開発してみたいよね。最近、各種SNSで使うためのプロフィールページなんぞを作ってみたんですよ。こういうの。 www.yuki2021.net で、今までやってきたことの棚卸しとかをやってみると、僕は絵を描いたりとか小説を書いたりみたいなことは割と熱心にやってるのに、プログラミングとか技術方面のことを疎かにしすぎだと思うんすよ。 曲がりなりにも僕は生業がプログラマであって、自分で何かアプリとか作ろうと思えば作れる環境も持っ…

youtu.be youtu.be youtu.be 【楽天スーパーセール12/10・12/11限定クーポンで3499円】新米 令和4年産 福島県産コシヒカリ お米 10kg 米 白米 送料無料 あす楽 5kg×2袋 【レビュー投稿でクーポンプレゼント】12時までの注文で即日発送可能価格：3999円（税込、送料無料) (2022/12/10時点) 楽天で購入 Edy-楽天ポイントカード ギンビス（たべっ子どうぶつ）【受注生産】価格：550円（税込、送料別) (2022/12/10時点) 楽天で購入 【55円セール実施中】Edy-楽天ポイントカード（Rシリーズ）価格：55円（税込、送料別) (2…

エンジニアとして英語のドキュメントは避けて通れません。自分の知りたいことを検索して、日本語のページだけを選択していても情報量が少ないですし、特殊な技術な場合は、日本語の情報がない場合もあります。英語は4人に1人が話す事が出来る言語でもあり英語のドキュメントの方が量も質も豊富です。そのため、エンジニアにとっては英語を読むことは、必要なスキルとなります。 1.単語だけ読む 先ずは分かる単語だけをパラパラとでも読んでみましょう。意外に中学校レベルの単語が並んでいるパターンが多いです。読むだけであれば、意味がなんとなく分かったりします。 例えば、jupyter notebookをmacに入れたいので、…

どうも、まさとらん（@0310lan）です！今回は、誰でも簡単に美しいオンラインドキュメントを無料で作成できるWebサービスをご紹介します！多彩なテンプレートやすぐに使えるコンテンツなどが搭載されているので、ちょっとしたドキュメントを作ってシェアするのに重宝します。また、カスタマイズ次第では個人サイトなどのWebページを公開する用途にも活用できるので、ご興味ある方はぜひ参考にしてください！ 【 Slick 】 ■「Slick」の使い方 それでは、「Slick」をどのように使えばいいのか詳しく見ていきましょう！まずはサイトのトップページから【Sign up】ボタンをクリックして、無料のユーザー登…

先月ノートパソコンを買い替えた。初めてのhp社の製品である。電源を入れると勝手にパソコンが次々と設定について指示してくれるので電話サポートを受けながら初期設定は心配をよそに順調に完了した。 最近はパソコン等に分厚いマニュアルは付いていない。今更ながらの感もあるが、特にファンクションキーはソフト？によっても違うらしくどんな意味や機能があるのかがわからない。 私の使い方程度であれば余り使わないキーも多いのだと思うけど、せっかく1か月の有料相談オプションを購入したので「マニュアル」はどこにあるのか問い合わせしてみた。回答までにしばらく時間がかかったところをみるとまんざら野暮な質問ではなかったと思う。…

『エンジニアなら知っておきたいシステム設計とドキュメント』（梅田 弘之，インプレス，2022年1月21日）を読了。 遅延原因のトップは，「システムの仕様変更が相次いだ」というものです。これは，それ自体が根本的な原因というよりも，例えば「要件定義や基本設計が甘かった」などによって生じたものと考えられます。（p. 11） 私が携わる業務システムの抜本的な改修は，要件定義のフェーズにある。 ここで，しっかり仕様を決めていけば，システムの仕様変更のリスクを低減することができる。 プロジェクト管理手法「PYRAMID」→統合型プロジェクト管理システム SI Object Browser PM 設計ドキュ…

はじめに こんにちは。システム事業部のTAKです。 私はWindows10内のWSL環境をローカル開発環境として使用しているのですが、従来のWSL環境ではsystemctlが使えなかったため、サービスの登録ができないなど少し残念な思いをしていました。 （なおWindows11&Ubuntu22.04.1であれば、昨年4月頃のWindows Updateにより今回紹介する内容が既に反映されています） ところが昨年の11月下旬にWSLアプリがMicrosoftストアで正式リリースとなりました。 元々Windowsに入っていたWSLをアプリとして切り出した形になりますが、主に以下のメリットが増えまし…

はじめまして、岡野真也(@tokibito)です。私は現在、ソフトウェアエンジニアとして働いており、株式会社ObotAIの取締役CTOと株式会社オープンコレクターの取締役として2社に所属しています。 エンジニアとして私はDjangoフレームワークを長く使っており、これと併せてPythonも15年以上利用しています。今回、私自身のキャリアについて振り返る機会をいただきました。私がどのように今の立場に至ったのか、技術への取り組み方、キャリアについての考えなどを語りたいと思います。 アウトプットをしながら勉強することでスキルを磨く プログラミングとの出会い ソフトウェアを公開するということ ライブラ…

PRです。最近は Go 中心のお仕事でしたが、今年は .NET に戻りつつありますのでメールフォーム的なものを .NET で作りました。 仕組みは簡単で以下の通りです。 API でフォームの内容を受ける(Azure Functions) 受信内容を登録（Azure Cosmos DB） メール送信などの通知処理を実行（Azure Cosmos DB の Change Feed でトリガーされる Azure Functions） 入力項目、バリデーションや通知設定は SQL Database や Azure Table Storage に入れてあります。 また、API Management 使っ…

Googleスプレッドシートで図形等を作成するのに用いる、図形描画機能の使い方についてです。 すべての機能は膨大な量になるので、ここでは図形等の作成と装飾・加工機能を中心に紹介します。 メニューから「挿入」→「図形描画」と選択すると図形描画のキャンバスが現れ、線や図形等を作成することができます。 図形描画キャンバスの開き方 主な操作 図形等の作成 ワードアートの作成 線や図形の加工 テキストの編集と調整 画像の加工 シート内への配置 編集の完了 コピーペーストについて 図形描画キャンバスの開き方 メニューから「挿入」→「図形描画」と選択します。 すると図形描画のキャンバスが現れます。上部にアイ…

はじめに Dataverseに対してBulk Insertを行う 登録データの作成 Bodyを作成する Dataverse Web APIを実行する おわりに はじめに この記事はPower Automateで色々なデータソースに対してBulk Insertを行うのDataverse編です。 登録を行う元データは上記記事の「Bulk Insert」セクションを参照してください。 Power Automateではデータソースに対してレコードを作成するアクションを標準で搭載してはいますが、どれも1件ずつの登録しかできません。 これでは例えば500件のデータを登録したい場合など、ループアクションが必…

最近は仕様を決めるお仕事をしている。自分の仕様もわからないのに、ソフトウェアの仕様を決めるなんて不可能だ。誰か早く仕様を決めてくれ。と思いながら、毎日ああでもないこうでもないと考える日々だ。考えているとき、常に、「この仕様で、本当に大丈夫なの？やりたいこと実現できるの？」という誰かの声が聞こえてくる。はっきり言って、わからん。これでいいのかどうか、ずっと、いつまでたっても自信がない。だいたい、ソフトウェアの仕様なんて言うものは、作りながら決まるものではないのか。作る前から仕様をきっちりと考えつくすなんて、不可能だ。一度自分でちょっとしたツールを作ってみればわかる。最初考えていた仕様から、いろい…

「Calendly」は多くのサービスとのインテグレーションをサポートしている．"Professional" プラン以上で使える「Zapier インテグレーション」で連携すると，開発をすることなく（ノーコード）イベント駆動な仕組みを実装できる． Calendly を試しながら「ミーティングの申し込みがあったら自動的に Notion にドキュメントを作る」ということを実現したく，トライアル期間中に Zapier との連携を実装してみた❗️実際に使っていて便利〜（課金したくなる...💰）プラン詳細は以下のドキュメントにまとまっている！ calendly.com Calendly に関しては以下の記事…

こんにちは。最近ジムに通い始めた島村です。 これまでジムは通ったことはなかったのですが、 効率よく筋肉を刺激することができて楽しく過ごせています。 この調子で筋肉を大きくしていけたらと思います。 さて、今回はECRのライフサイクルポリシーの機能の解説と 実際に試して機能を試していきたいと思います。 ECRライフサイクルポリシーとは何か まず、ECRのライフサイクルポリシーはプライベートリポジトリごとに設定が可能です。 ※パブリックリポジトリでは設定することができません。 ライフサイクルを定義することで、条件に合致したイメージを削除することが可能です。 リポジトリ内のイメージを効率よく整理するこ…

新宿駅東口に到着しました。 新宿武蔵野館さんに伺います。 ３階に移動します。 この日は、珍しく何を観るか分かっています。 「カンフースタントマン」なる映画を観ます。 到着してすぐ憚りに急ぎます。 席に着いたら、２分の予告編の後に、本編上映開始です。 ーーーーー 感想です。（ネタバレがあります！） 香港のカンフーアクション映画、そのスタントマンたちの話です。 実録ドキュメントって感じの話です。 京劇の学校で修行を積んだ子供たちが、映画のスタント役をやるようになる・・・ ブルース・リーの出現と、突然の逝去。 サモハンキンポー、ジャッキーチェンの出現 映画の低迷期。 中国本土での映画撮影と、武術指導…

Elasticsearchではデータの登録時にBulk APIを使用して、大量データを登録することができます。 これにより、登録時のオーバヘッドが削減でき、インデックスの作成速度を大幅に向上できます。 www.elastic.co Bulk APIで登録するときのデータ形式は以下のように設定します。 { "index" : { "_index" : "test", "_id" : "1" } } { "field1" : "value1" } ここからは、Bulk APIの使用時に注意するポイントを以下で順に説明します。 データの最終行は、改行文字で終了する必要がある 用意するデータの最終行は…

突然ですが、皆さんは下の写真の方をご存じですか？ (目を引くビジュアルですよね） 私がこの方を知ったきっかけは、NHKの『ドキュメント72時間』という番組です。 『ドキュメント72時間』は3日間、つまり72時間、ある場所を撮影し続けて、そこに集う人々の人生模様を切り取っていくというテーマの番組です。 最近はほとんど見てないのですが、数年前まで好きで結構よく見ていました。 大宮の喫茶店とか、秋田のうどん自販機とか、函館のラッキーピエロとか、今でも記憶に残っている作品が沢山あります。 その中で、新宿の郵便局を取材した回（番組タイトル『消印有効 24時間マンモス郵便局』）があり、そこでたまたま荷物を…

今日はドキュメントやテストの小さな変更だけでした。 [b432867429] Hiroshi SHIBATA 2023-01-30 07:55:14 UTC 拡張ライブラリ openssl のテストで RHEL の 9 でうまく動かないものがあったとのことで Etc.uname でチェックして skip するようにしています。 [1c7bf378a1] git 2023-01-30 08:29:31 UTC NEWS の default gems のバージョンリストに abbrev が記述されてましたが 3.3.x になってからの更新はないので削除しています。自動更新用のスクリプトが参照してい…