並び順

ブックマーク数

期間指定

  • から
  • まで

521 - 560 件 / 1256件

新着順 人気順

ドキュメントの検索結果521 - 560 件 / 1256件

  • Markdownでドキュメントが作れるMkDocsが便利過ぎる - Qiita

    何番煎じだろうと書く。 顧客向けマニュアルをMarkdownで作りたい ここ最近、社内で利用する仕様書だったり手順書だったりはCrowiでMarkdownで書いています。Markdown、手軽で便利ですよね。 ただ、お客様に提出するような製品仕様や製品マニュアルを公開するのは、セキュリティとかアカウント管理とかの関係でちょっと公開するのはいかがなものかなと。 記事のエクスポート機能でもあればなーと思っていたところで、MkDocsに出会いました。割と感動したので、この感動を皆様と共有したく。 公式サイト 何が凄いのか Markdownでドキュメントが書ける webサービスを内蔵しているので、わざわざwebサーバーを立てなくてよい webサービスはMarkdownへの変更をリアルタイムに反映してくれる テーマが選択できるのでデザインセンスがなくても割といい感じにしてくれる 1コマンドで静的サイ

      Markdownでドキュメントが作れるMkDocsが便利過ぎる - Qiita
    • 公式ドキュメントのユースケース

      README.md Ref なぜ僕は公式ドキュメントを読むのが苦手なのか #初心者 - Qiita 次のようなセクションがあった場合、何を読むかというのはその目的によって異なるという印象。 Getting Started: インストール、セットアップ Tutorial: 基本的な使い方(代表的な使い方) Concepts: デザインのコンセプト、なぜ作ったか Examples: 動くサンプル API Reference: APIのリファレンス 目的によっては、公式ドキュメントじゃない方が理解しやすい場合もあります。 ただし、公式ドキュメントに書かれていることが大体のケースでは正確なので、 どの目的の場合でも「リファレンス」として公式ドキュメントを併せて参照するのは有用です。 e.g. ブログ記事でインストール方法が紹介されていた時に、公式ドキュメントではどういう方法でインストールを推奨して

        公式ドキュメントのユースケース
      • 「大砲や戦車、ゴミ溜めしかない」と島民 旧ソ連出身監督による国後島ドキュメント公開、島の生活が見える予告編 : 映画ニュース - 映画.com

        ホーム > 映画ニュース > 2021年10月13日 > 「大砲や戦車、ゴミ溜めしかない」と島民 旧ソ連出身監督による国後島ドキュメント公開、島の生活が見える予告編 北方領土の国後島のドキュメンタリー(C)Les Films du Temps Scelle - Les Docs du Nord 2019 旧ソ連出身フランス在住の監督による、北方領土の国後島のドキュメンタリー「クナシリ」が、12月4日から公開される。政治に翻弄され、複雑な思いを抱える島民らが現状を嘆き、率直に生活苦を語る。ロシア側の主張に偏ることなく、日本ではあまり知られていない島民の証言や生活の実態を映し出している。 北海道からわずか16キロに位置し、かつては四島全体で約1万7000人の日本人が生活していた北方領土。しかし、戦後の1947年から48年にかけて強制退去が行われ、現在は日本人がひとりもおらず、日本政府は問題が解

          「大砲や戦車、ゴミ溜めしかない」と島民 旧ソ連出身監督による国後島ドキュメント公開、島の生活が見える予告編 : 映画ニュース - 映画.com
        • 『佐渡金山400年の歴史』江戸金山絵巻散策ドキュメント ^^! - kzのブログ

          『佐渡金山400年の歴史』 江戸金山絵巻 散策ドキュメント ^^! 念願の佐渡へ 此処は外せないよね www.youtube.com 産出し製錬された筋金(すじきん/すじがね)および灰吹銀は幕府に上納され、 これを金座および銀座が預かり貨幣に鋳造した ek0901.hatenablog.com 佐渡国が徳川家康の領地となったのは 1600年(慶長5) www.youtube.com ek0901.hatenablog.com 佐渡奉行は、江戸時代の官職の一つ 老中配下の遠国奉行の一つで、関ヶ原の戦いを経て 佐渡が上杉氏から幕府の支配下となった慶長6年 (1601年)に設置された ❢

            『佐渡金山400年の歴史』江戸金山絵巻散策ドキュメント ^^! - kzのブログ
          • ドキュメントチャットボット

            アップロードしたファイルがこのサービス以外の目的に使用されることはありません。 ファイルはサービス利用後に削除することが可能です。また、アップロード後1週間で自動的に削除されます。 サイズは20MBまで。 AIは最初の50ページまでの情報で回答します。 日本語以外の書類に対しても日本語で質問できます。

              ドキュメントチャットボット
            • Amazon TranslateがOfficeドキュメントに対応。WordやExcel、PowerPointファイルの中身を別言語に翻訳

              Amazon TranslateがOfficeドキュメントに対応。WordやExcel、PowerPointファイルの中身を別言語に翻訳 Amazon Web Services(AWS)は、深層学習モデルを利用した機械翻訳サービスのAmazon Translateが、Officeドキュメントに対応したことを発表しました。 New #AWSLaunches! AWS Directory Service for Microsoft Active Directory & AD Connector are now available in the AWS Africa (Cape Town) & AWS Europe (Milan) Regions Amazon Translate now supports translation of Office Open XML documentshttps

                Amazon TranslateがOfficeドキュメントに対応。WordやExcel、PowerPointファイルの中身を別言語に翻訳
              • 逆再生ドキュメント 東京藝術大学卒業作品展 - 幸せなことだけをして生きていきたい

                これすごいです。 再放送あります 逆再生ドキュメント「東京藝術大学卒業作品展」 NHKBSプレミアム 6月5日(日)午前0:50~ www.nhk.jp 東京藝術大学・卒業作品展。大学生活の“集大成”には、どんな思いが込められていたのか。展示当日から時をさかのぼり、若き芸術家たちの創造の原点を探るドキュメント。 日本の芸術分野の最高学府と言われる、東京藝術大学。毎年1月末から開催される卒業作品展には、若き芸術家たちの渾身の作品が並ぶ。番組では、4人の藝大生の卒業作品展までの200日を取材。制作過程を現在から過去へ、展示当日から時をさかのぼって見つめていき、作品の真のねらいや創造の原点を探っていく。完成作品を番組の最後に再び目にしたとき、私たちは何を感じるのだろうか。ナレーションは井口理(King Gnu) 逆再生していく試みは斬新。 成功しているかどうかはともかくとして、面白かった。 芸大

                  逆再生ドキュメント 東京藝術大学卒業作品展 - 幸せなことだけをして生きていきたい
                • 最近の音声入力体制は、リモートマウス+Voice In+Googleドキュメントの組み合わせです。これで文章の大量生産ができます。 - 勝間和代が徹底的にマニアックな話をアップするブログ

                  相変わらず毎日せっせと音声入力をしています。今年は少し昨年よりも多めに本を出そうと思ってるので、原稿の執筆にもいそしんでいます。 音声入力に関しては三つを組み合わせて使っています。 基本的には ・アンドロイドからのリモートマウスをメイン にして、タブレットから入力をしているのですが、リモートマウスの場合には、いちいち、これから入力をするよということと、これからこの文字をWindowsに送るよということでボタンを2回押す必要があるので、長文の時にはリモート回すが便利なんですけれども、ほんの1行2行返信をしたいとかあれはちょっとしたリモートマウスが間違って認識した単語を書き換えたいという時には ・Chromeの拡張機能のVoiceIn(中身はGoogle音声入力)をサブ に使って短い文章を入れています。 また、原稿はほとんどGoogleドキュメントで書いているのですが、リモートマウスで間違って

                    最近の音声入力体制は、リモートマウス+Voice In+Googleドキュメントの組み合わせです。これで文章の大量生産ができます。 - 勝間和代が徹底的にマニアックな話をアップするブログ
                  • 週刊Railsウォッチ: Turbo 8リリース、Railsドキュメント改善プロジェクトほか(20240215)|TechRacho by BPS株式会社

                    こんにちは、hachi8833です。技術評論社のRuby 3.3記事、まだまだありました🙇。 > 新しいIRBでは行末に;をつけると出力を抑制できます。 知らなかった。便利すぎる。;を付けなくてもデフォルトで抑制できるオプションとかありそう。 というかirb & debugを極めるとめちゃくちゃ生産性上がりそう。今度リファレンスマニュアル眺めてみよう。https://t.co/1btnbrfXPL — Masafumi Koba 🇺🇦 (@ybiquitous) January 25, 2024 Ruby 3.3リリース! 新機能解説 「M:Nスレッドによる軽量な並行処理への挑戦」 公開 https://t.co/Atv0p8wFpx — gihyo.jp (@gihyojp) January 30, 2024 Ruby 3.3リリース! 新機能解説 「徹底解説! default g

                      週刊Railsウォッチ: Turbo 8リリース、Railsドキュメント改善プロジェクトほか(20240215)|TechRacho by BPS株式会社
                    • terraform-docsをGithub Actions上で実行して、プルリクエスト時にモジュールのドキュメントを自動生成してみる | DevelopersIO

                      「terraform モジュールのドキュメントを簡単に作成したい」 terrafrom moduleの自動生成に便利な terraform-docs みなさん使っていますか? 今回は、terraform-docsをGithub Actions上で動かして、プルリクエスト時にモジュールのドキュメントを 自動生成してみます。 terraform-docsとは terraform-docsは、 terraformモジュールからREADMEなどドキュメントを生成することができるツールです。 Introduction | terraform-docs コマンド一つで、以下のようにドキュメントを作成してくれます。 $ terraform-docs markdown <モジュールディレクトリ> やってみた 手動で実行するだけでも便利ですが、モジュールを更新した際に自動で実行してくれたらさらに便利そうです

                        terraform-docsをGithub Actions上で実行して、プルリクエスト時にモジュールのドキュメントを自動生成してみる | DevelopersIO
                      • ドキュメントフォルダを移動できない問題に対処。Windows10 「同じ場所にリダイレクトできない」エラー | ホームページ制作 オフィスオバタ

                        ドキュメントフォルダを移動できない問題に対処。Windows10 「同じ場所にリダイレクトできない」エラー 2019年12月3日 パソコンにHDDを増設し、ドキュメントフォルダーをC:→D:へ移動しようとしたら、 「同じ場所にリダイレクトできないフォルダーがあるため、フォルダーを移動できません。アクセスが拒否されました。」 というエラーが出て、フォルダの場所を変更できない問題が発生しました。 いろいろ調べて対処できましたので、忘備録として記録いたします。 原因をググって調べたら、Ondriveフォルダ内ドキュメントによる問題でした。 いつものようにググって調べました。 Onedrive同期フォルダの中に、ドキュメントフォルダがあることがエラーの原因でした。 Onedriveフォルダは「ネット同期」する特性上場所の変更はできません。 だからOnedriveフォルダ内にあったドキュメントフォル

                          ドキュメントフォルダを移動できない問題に対処。Windows10 「同じ場所にリダイレクトできない」エラー | ホームページ制作 オフィスオバタ
                        • Next.js にレイアウトに関するドキュメントが追加されました - ROXX開発者ブログ

                          この記事は個人ブログと同じ内容です zenn.dev Next.js の Layout 周りのドキュメントが新しく追加されました。 単一のレイアウトを扱う場合 単一のレイアウトで十分な場合はカスタマイズした <Layout/> で <Component /> タグを囲むだけで実装できます。 // pages/_app.js import Layout from '../components/layout' export default function MyApp({ Component, pageProps }) { return ( <> // Layout でアプリケーションのコンポーネントを囲むだけ <Layout> <Component {...pageProps} /> </Layout> </> ) } ページごとに異なるレイアウトを扱う場合 ページごとに異なるレイアウトが必

                            Next.js にレイアウトに関するドキュメントが追加されました - ROXX開発者ブログ
                          • Docker デーモンをルート以外のユーザで実行(Rootless モード) — Docker-docs-ja 24.0 ドキュメント

                            Rootless モード(Rootless mode)は Docker デーモンとコンテナを root 以外のユーザが実行できるようにするもので、デーモンやコンテナ・ランタイムにおける潜在的な脆弱性を回避します。 Rootless モードは Docker デーモンのインストールに root 権限を必要としないだけでなく、 事前準備 においても不要です。 Rootless モードは Docker Engine v19.03 から導入されました。

                            • DeepL Pro サイト翻訳で英語ドキュメントを快適に読む

                              問題 DeepL Pro のウェブサイト翻訳は便利ですが、プログラミング関連の記事に適用すると以下のようにソースコード等の翻訳されてほしくない箇所まで翻訳されてしまい、翻って読みづらくなります。 解決策 DeepL にはHTML中に class="notranslate" もしくは translate="no" 属性があると、その範囲を翻訳しないという仕様があります(Google翻訳由来の仕様らしい)。 DeepL API: Disabling translation of elements そこでTampermonkeyを使って、以下のような UserScript で翻訳したくないタグに class="notranslate" を追加して、再度 DeepL を適用します。 // ==UserScript== // @name add-notranslate-class-to-code-r

                                DeepL Pro サイト翻訳で英語ドキュメントを快適に読む
                              • 「G Suiteではじめるテレワーク活用術」ノウハウまとめ、ストリートスマートが公開 テレビ会議「Hangouts Meet」とカレンダーとの連携や会議中のドキュメント共有など

                                  「G Suiteではじめるテレワーク活用術」ノウハウまとめ、ストリートスマートが公開 テレビ会議「Hangouts Meet」とカレンダーとの連携や会議中のドキュメント共有など
                                • GKE のリリースノート(コンテナネイティブなロードバランス)を読み解くのに必要な知識は、公式ドキュメントのどこに書いてあるか?

                                  Google Cloud のカスタマーエンジニアの田中です。 最近 GKE でコンテナネイティブなロードバランスの機能を正式サポートしたという発表がありました。 コンテナネイティブなロードバランス機能を使うと、KubernetesのIngressコントローラに新しくNetwork Endpoint Groups(NEG)と呼ばれるレイヤが組み込まれ、コンテナに対して直接負荷分散を行うことで、従来にくらべてコンテナに到達するまでのホップ数を減らし、レイテンシーの向上を期待できる場合があります。 ところでこの機能を使うには、発表記事の一番下の方にも記載があるのですが、GKE クラスタでVPC-native を有効化している必要があります。 You can use container-native load balancing in several scenarios. For example,

                                    GKE のリリースノート(コンテナネイティブなロードバランス)を読み解くのに必要な知識は、公式ドキュメントのどこに書いてあるか?
                                  • Xcodeのキャッシュを抽出/削除できるユーティリティ「DevCleaner for Xcode v2.0」がリリース。レガシィドキュメントやログの削除機能とコマンドラインツールを追加。

                                    Xcodeのキャッシュを抽出/削除できるユーティリティアプリ「DevCleaner for Xcode v2.0」がリリースされています。詳細は以下から。 DevCleaner for Xcodeはポーランドでインディーゲームなどを開発しているKonrad Kołakowskiさんが公開した開発者向けユーティリティで、”~/Developer”ディレクトリ内にあるiOSやwatchOS、tvOSシミュレーターやプロジェクトのキャッシュ、ログ、アーカイブなどを抽出し削除できる機能がありますが、このアプリが「DevCleaner for Xcode v2.0」としてメジャーアップデートしています。 This is a big update for DevCleaner, enjoy and clean even more space! This update brings following

                                      Xcodeのキャッシュを抽出/削除できるユーティリティ「DevCleaner for Xcode v2.0」がリリース。レガシィドキュメントやログの削除機能とコマンドラインツールを追加。
                                    • 書く側も読む側も大きな負担なく取り組めるドキュメント運用 文化醸成のための3つの取り組みと、4種類の運用ドキュメント

                                      Launchable, Inc.のソフトウェアエンジニアであるこんぼい氏は、ドキュメントを大事にしている理由と、具体的にどのようなドキュメントを運用しているのか、また、ドキュメント文化醸造のための取り組みについて紹介しました。全2回。前回はこちらから。 運用ドキュメント1 Project Proposal こんぼい氏:ここからがメインパートというか、どんなドキュメントを運用しているのかを紹介していければなと思います。 いろいろなドキュメントがあるんですが、今回は4つ例を持ってきました。1つ目がProject Proposal、2つ目がDACI(Driver, Approver, Contributors, Informed)、Postmortem、CS Investigation Logというかたちで持ってきました。 まず1つ目がProject Proposalですね。読んで字のごとくじゃ

                                        書く側も読む側も大きな負担なく取り組めるドキュメント運用 文化醸成のための3つの取り組みと、4種類の運用ドキュメント
                                      • TSConfig リファレンス - すべてのTSConfigのオプションのドキュメント

                                        Type CheckingallowUnreachableCode, allowUnusedLabels, alwaysStrict, exactOptionalPropertyTypes, noFallthroughCasesInSwitch, noImplicitAny, noImplicitOverride, noImplicitReturns, noImplicitThis, noPropertyAccessFromIndexSignature, noUncheckedIndexedAccess, noUnusedLocals, noUnusedParameters, strict, strictBindCallApply, strictFunctionTypes, strictNullChecks, strictPropertyInitialization and useUnkn

                                        • エンジニアのドキュメント作成に適した「AsciiDoc」とは?

                                          はじめに 流用性・検索性が高いドキュメントの作成は今後のエンジニアに求められるスキルの一つです。 一方で社内ではPowerPointやWordによるドキュメント作成が頻繁に行われる事が多いのではないでしょうか?PowerPointやWordは即時性が高いフォーマットですが、流用性・検索性を確保し続ける事が困難です。 エンジニアが気軽に出版レベルのドキュメントを作成したり、Wikiより管理の容易なナレッジを作成するのに役立つAsciiDocをご紹介するとともに、より柔軟な運用について提案したいと思います。 AsciiDocとは AsciiDocは軽量マークアップ言語の一つで可読文書記述形式です。 出力もHTML, PDF, ePubなどが行えるため個人での出版活動から開発環境でのナレッジの共有まで様々な用途で利用する事が可能です。 AsciiDocの記述方法 軽量マークアップ言語でメジャーな

                                            エンジニアのドキュメント作成に適した「AsciiDoc」とは?
                                          • デザインドキュメントを知るための参考リンク集 - Qiita

                                            自分もデザインドキュメントを始めようと思ったので、デザインドキュメントとは何かを知るために情報収集した結果と簡単な自分の考えのまとめ。 デザインドキュメント概要 [2007-06-01] Software Engineer in Google - Google Developer Day Tokyo 2007 Googleのソフトウェアエンジニアがどのように開発しているのかという発表で、プロダクト開発の流れの中でデザインドキュメントを利用していることが説明されている Why(背景や目的)、How(おおまかな設計、コードを見てわかることは書かない)、Who(メンバ、誰にコンタクトすればそのプロダクトについて知れるか)、セキュリティやプライバシーに関する考慮、テストやモニタリングをコーディング前に記述する。開発を進める中でできるだけ乖離しないように修正する。 この発表内容に関する聴講者のメモ:

                                              デザインドキュメントを知るための参考リンク集 - Qiita
                                            • ビルド不要のドキュメントサイトジェネレーター「docsify」の個人的まとめ - Qiita

                                              この記事は、 ドキュメント静的サイトジェネレーターである docsify の使い方について 個人的にまとめたものです。 はじめに 想定読者 Markdown について知っている 開発が活発にされなくなった gitbook-cli の代替を探している 日本語検索に対応している 静的サイトジェネレーター が欲しい この記事で得られること docsify の基本的な使い方 お手軽なドキュメント作成方法 この記事で得られないこと 公式ドキュメントに記載されている細かい仕様 他の静的サイトジェネレーターについて Node.js の環境準備方法 docsifyの特徴 docsify とは 「docsify」は、公式を直訳すると 魔法のドキュメントサイトジェネレーター です。 すなわち、ドキュメントを作成するツールです。 どのあたりが魔法かというと、 markdown などから html を生成する 静

                                                ビルド不要のドキュメントサイトジェネレーター「docsify」の個人的まとめ - Qiita
                                              • 【Office365参考書】SharePointサイトのドキュメントライブラリのアイテムを別サイトに移動するには? - 社畜の所業

                                                同一 Office365 テナントに存在している SharePont サイト間でドキュメントライブラリのアイテムを移行する場合は、[移動] の機能をご利用いただくことでローカルに保存せずに移動することが可能です。 ※ 移行元サイト、移行先サイトの両方にアクセス権を付与していただく必要があります。 なお、[移動] は、以下の制限がございますので、1 回の操作で制限を超える場合は、範囲内で複数回で実施ください。 ・ファイルサイズの合計は 100 GB 以下 ・3万を超えるファイル ・各ファイルは 2 GB 未満 docs.microsoft.com サイト間のファイルを移動する手順 移行元のサイトにて、ドキュメントライブラリにアクセスします。 移動するファイルやフォルダの左側にチェックを入れ、選択します。 上部の [移動] をクリックします。 ※ 表示されていない場合は、[…] > [移動]

                                                  【Office365参考書】SharePointサイトのドキュメントライブラリのアイテムを別サイトに移動するには? - 社畜の所業
                                                • ページ エクスペリエンスと Google 検索結果への影響 | Google 検索セントラル  |  ドキュメント  |  Google for Developers

                                                  フィードバックを送信 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。 ページ エクスペリエンスの Google 検索結果への影響について Google のコア ランキング システムは、優れたページ エクスペリエンスを提供するコンテンツを高く評価するように設計されています。サイト所有者が Google のシステムで高い評価を得るには、ページ エクスペリエンスの限られた要素のみにとらわれないようにすることが必要です。多くの要素について検討し、全般的に優れたページ エクスペリエンスを提供できているかどうかを確認してください。 コンテンツのページ エクスペリエンスを自己評価する 以下の質問に対する答えが「はい」の場合は、優れたページ エクスペリエンスを提供するために正しい方向に進んでいるといえるでしょう。 ページの Core Web Vitals は良好な状態です

                                                    ページ エクスペリエンスと Google 検索結果への影響 | Google 検索セントラル  |  ドキュメント  |  Google for Developers
                                                  • 残して良かったドキュメント、いまいちだったドキュメント - Qiita

                                                    この記事の概要 エンジニア的な文化・行動として「ドキュメントを残そう」をよく聞きますよね。 私の在籍するQiita株式会社では、社内の情報共有もかなり強く意識しています。 普段からドキュメントを残している中で、どんなものが効果的だったかを記事にしてみました。 なお、ここでいうドキュメントとはコード内のコメントやREADMEではなく社内Wikiのようなものを指しています。 定期的に人に説明する内容 入社時にやること 今導入している技術やサービスのまとめ 制度上のフローやガイドラインなど 新しく入社した人に説明する内容や、チーム間で異動があったら共有すべき内容などのイメージ。 自分は「この内容、何度か人に説明してるなあ」と気付いたらドキュメント化するよう心がけています。 また、これらがしっかり残っていると、次の「新しく何かを始める際の記録」が取りやすくなります。 新しく何かを始める際の記録 技

                                                      残して良かったドキュメント、いまいちだったドキュメント - Qiita
                                                    • Rails: ActiveRecord::DelegatedType APIドキュメント(翻訳)|TechRacho by BPS株式会社

                                                      概要 MITライセンスに基づいて翻訳・公開いたします。 APIドキュメント: ActiveRecord::DelegatedType リポジトリ: rails/delegated_type.rb at main · rails/rails 原文更新日: 2021/11/03(57fe7df) ライセンス: MIT ActiveRecord::DelegatedTypeはRails 6.1以降で利用できます。delegated typeは英ママとしました。 週刊Railsウォッチ20200601 新機能: Active Recordにdelegated_typeが追加もどうぞ。 また、Rails 7ではaccepts_nested_attributes_forもサポートされています。 週刊Railsウォッチ20211115前編 delegated_typeでaccepts_nested_at

                                                        Rails: ActiveRecord::DelegatedType APIドキュメント(翻訳)|TechRacho by BPS株式会社
                                                      • Spring Boot コア機能 - リファレンスドキュメント

                                                        import org.springframework.boot.autoconfigure.SpringBootApplication import org.springframework.boot.runApplication @SpringBootApplication class MyApplication fun main(args: Array<String>) { runApplication<MyApplication>(*args) } . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / /

                                                          Spring Boot コア機能 - リファレンスドキュメント
                                                        • 【プロジェクト管理】Figmaで仕様書を作ったら、わかりやすいドキュメントになった - Qiita

                                                          はじめに プロジェクトを進めていく中で、ドキュメンテーションは大切だと言われています。 特に、仕様漏れや言った・聞いてない問題などを解決するためにドキュメントにまとめておくことを薦める記事はよく見ると思います。 また、ドキュメントの種類も様々で、要件定義書・基本設計書・詳細設計書 など、 開発に関わる人達のコミュニケーションや情報共有する手段として使用されます。 そんな中で、Qiitaでは、職種を跨いだ情報共有に課題を感じていました。 特に、デザイナーとエンジニア間でのフロントエンドの仕様を共有することに課題がありました。 課題を解決するために、いくつかの情報共有方法を試みた結果、 ドキュメント更新の負担が少なく、保守性の高い方法にたどり着いたので紹介します。 前提 開発におけるQiitaでの役割分担 【デザイナーの役割】 Qiitaでの開発におけるデザイナーの役割は、 体験(UX)・情報

                                                            【プロジェクト管理】Figmaで仕様書を作ったら、わかりやすいドキュメントになった - Qiita
                                                          • Prometheus公式ドキュメント和訳+α - it-engineer’s blog

                                                            Prometheus公式ドキュメントの和訳をしています。 +αとして公式ドキュメント以外にも有益そうで日本語版のない情報を和訳しています。 Prometheus日本語ドキュメント目次 打ち消し線の項目は、未翻訳(または一部のみ翻訳済み)で、ドキュメント原文へのリンクになっています。 翻訳済みのページだけ読みたい場合は、Prometheus カテゴリーの記事一覧からどうぞ。 日本語書籍もおすすめなので購入を検討してみて下さい。 入門 Prometheus ―インフラとアプリケーションのパフォーマンスモニタリング 作者: Brian Brazil,須田一輝,長尾高弘出版社/メーカー: オライリージャパン発売日: 2019/05/18メディア: 単行本(ソフトカバー)この商品を含むブログを見る Introduction 概要 初めの一歩 Comparison to alternatives FA

                                                              Prometheus公式ドキュメント和訳+α - it-engineer’s blog
                                                            • Docker Desktop WSL 2 バックエンド — Docker-docs-ja 20.10 ドキュメント

                                                              新しい Docker Desktop WSL 2 バックエンドは、Docker Desktop WSL 2 Tech Preview の後を継ぐものです。WSL2 バックエンド・アーキテクチャは Kubernetes 向けのサポートを導入し、更新版 Docker デーモンの提供、VPN と親和性のあるネットワーク機能や追加機能を提供します。WSL 2 は構造上の著しい変更をもたらします。Microsoft によってビルドされた完全な Linux カーネルによって、エミュレーションではなく、ネイティブに Linux コンテナを実行可能になります。WSL 2 上で Docker Desktop を実行しますと、利用者は Linux ワークスペースを活用できるようになり、また、ビルド用スクリプトは Windows 用と Linux 用との両方を準備する必要がなくなります。 また、Docker D

                                                              • 「体育祭なんか行くんじゃねぇ」ズボンをアイロンで乾かし父親が激高…青葉真司被告の“壮絶”家庭環境「逆らえない」絶対的服従に近い父親への忠誠心【ドキュメント京アニ裁判⑤被告人質問】 | TBS NEWS DIG

                                                                「体育祭なんか行くんじゃねぇ」ズボンをアイロンで乾かし父親が激高…青葉真司被告の“壮絶”家庭環境「逆らえない」絶対的服従に近い父親への忠誠心【ドキュメント京アニ裁判⑤被告人質問】

                                                                  「体育祭なんか行くんじゃねぇ」ズボンをアイロンで乾かし父親が激高…青葉真司被告の“壮絶”家庭環境「逆らえない」絶対的服従に近い父親への忠誠心【ドキュメント京アニ裁判⑤被告人質問】 | TBS NEWS DIG
                                                                • YAPC::Kyoto 2023 に参加してきた - ドキュメントを見たほうが早い

                                                                  3月18, 19日の2日間、YAPC::Kyoto 2023 に参加してきました。 yapcjapan.org 4年ぶりのリアルイベント ここまで大きなリアルイベントは2019年に参加した YAPC::Tokyo 2019 以来で4年ぶりの参加だった。 リアルの会場に行って人と話すイベントはやっぱり良いものだなと思い直した2日間だと思った。 発表を聞いたり他の参加者の人と話したりすると「自分も何かしたいな」とか「コード書きたいな」など不思議とやる気になれる。 これが刺激になるって感覚なのかもしれないけど、この感覚を本当に久し振りに得ることが出来てとてもよかったと思う。 会話しに行く感覚を忘れていたことの若干の心残り 色々な人と話をしたものの以前会ったことのある人とか終わった後の別の場での会話がメインだった。 やっぱり会場で話すってことをもう少しできるとよかったなと思っていて、そこがちょっと

                                                                    YAPC::Kyoto 2023 に参加してきた - ドキュメントを見たほうが早い
                                                                  • ドキュメントによる情報共有と公開範囲について - fujimuradaisuke's blog

                                                                    基本全公開のesa、例外的に公開範囲限定のGoogle Docsという構成がよいと思っている 細かい公開範囲設定ができるツールを使うと、人間は公開範囲を設定してしまう 人間の行動は環境に規定される 公開範囲の設定が可能なツールを使うと、ドキュメントを書く度に「これはどこまで公開すればいいのか」という問いが無意識に生まれ、公開範囲を制限する、という選択肢が生まれる 全公開 or 制限という判断を迫られると人は安全側に倒れてしまうので、公開範囲を制限することになる 結果、多くのドキュメントは全公開ではなく、公開範囲が設定されることになる これにより細かいところで情報の非対称性が生まれる ドキュメントを読んでいて、そこにある別のドキュメントへのリンクを辿るが見えない、など バックグラウンドを詳しく知りたい、というWhyから考える精神の働きを妨げる esaは公開範囲の設定ができない 標準のドキュメ

                                                                      ドキュメントによる情報共有と公開範囲について - fujimuradaisuke's blog
                                                                    • Stoplight Studio - Web APIの設計とドキュメントを管理するエディタ

                                                                      MOONGIFTはオープンソース・ソフトウェアを紹介するブログです。2021年07月16日で更新停止しました Web APIを綺麗に設計するのはとても大変です。リソース名の決め方一つとってもそうですし、単純にCRUD操作だけで済まない場合のアクション名をどう指定するか、HTTPメソッドを何にするかといった問題もあります。 今回紹介するStoplight StudioはWeb APIのデザイン、ドキュメント整備を一括して行えるエディタです。 Stoplight Studioの使い方 まず組織、そしてプロジェクトを作成します。 リファレンスを作成します。ドメインを指定します。 APIキーベースの認証などを指定できます。 パスを設計します。 エクスポート機能があります。 ドキュメント。 OASベースのYAMLでも内容を編集できます。 プレビューもあります。 Stoplight Studioを使う

                                                                        Stoplight Studio - Web APIの設計とドキュメントを管理するエディタ
                                                                      • 「逆にお聞きしますが、僕がパクられた時に京アニは何か感じたんでしょうか」言い返す青葉被告を裁判長が制止した 遺族がはじめて被告人質問に立つ【ドキュメント京アニ裁判⑪】 | TBS NEWS DIG

                                                                        「逆にお聞きしますが、僕がパクられた時に京アニは何か感じたんでしょうか」言い返す青葉被告を裁判長が制止した 遺族がはじめて被告人質問に立つ【ドキュメント京アニ裁判⑪】

                                                                          「逆にお聞きしますが、僕がパクられた時に京アニは何か感じたんでしょうか」言い返す青葉被告を裁判長が制止した 遺族がはじめて被告人質問に立つ【ドキュメント京アニ裁判⑪】 | TBS NEWS DIG
                                                                        • レビューの書き方 | Google 検索セントラル  |  ドキュメント  |  Google for Developers

                                                                          フィードバックを送信 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。 質の高いレビューを書く 質の高いレビューを掲載することで、ユーザーは、検討している商品やサービス、旅行先、ゲーム、映画などについて、より詳しく知ることができます。たとえば、次のような方々にレビューを書いていただけます。 競合する複数の商品に関する情報を提供する専門スタッフや販売員。 独自の意見を発信するブロガー。 ニュースサイトや出版サイトなどの編集スタッフ。 Google 検索などの Google サービスでレビューページに目をとめてもらえるように、以下のおすすめの方法を参考にしてください。 ユーザーの目線で評価します。 レビューしている商品についての知識が豊富であること、専門家であることを示します。 画像、音声、またはレビュー内容に関する自分自身の体験談へのリンクなど、専門知識を示し

                                                                            レビューの書き方 | Google 検索セントラル  |  ドキュメント  |  Google for Developers
                                                                          • ドキュメント「フードデリバリー配達員の記録」を始めます。#0 - ねこせんのライフスタイル 生活はつづく

                                                                            フードデリバリーの仕事を開始しました。その体験記を今後、記事にしていこうと思います。今日はプロローグ的な記事です。 私が、ガチのバイク便を辞めた理由 ブログを初期から読んでくださってる方は、知ってるかもしれませんが、私は都内でバイク便の仕事を6年ぐらいやっていました。大きな箱を乗せて書類とか運ぶガチなヤツです。2020年8月末で完全に稼働を辞めました。(籍は残っている、個人事業主なので退職とかではない) 理由としては、コロナの影響で仕事減りました。在宅ワークが増えて書類を物理的に運ぶ必要がないことに気づいたんじゃないでしょうか? 私は、印刷関係の所に専属で入ってたのですが、イベントや飲食店などの仕事が減ったせいか印刷物の仕事も減り、経費削減で自社で配送するということで契約がおわりました。 フリーの仕事はできるのですがこれを機会に辞めることにしました。元々繋ぎの仕事のつもりが本業になってしま

                                                                              ドキュメント「フードデリバリー配達員の記録」を始めます。#0 - ねこせんのライフスタイル 生活はつづく
                                                                            • 森達也監督に聞く『i -新聞記者ドキュメント-』であぶり出した“忖度の正体”

                                                                              ひとびとが“自動忖度機”と化す日本の怪現象は、いまに始まったことではない。『放送禁止歌』から20年、「事態ははるかに進んでいる」と言う。

                                                                                森達也監督に聞く『i -新聞記者ドキュメント-』であぶり出した“忖度の正体”
                                                                              • アクセシビリティに興味を持ち始めたきっかけ - ドキュメントを見たほうが早い

                                                                                アクセシビリティの琴線に触れるいくつかのアプローチ の記事を読んで、自分がアクセシビリティに興味を持ち始めたきっかけについて書き残しておきたくなったので書く。 自分の場合はアンチャーテッドというゲームのメイキングインタビュー動画をみたのが、アクセシビリティを意識するようになったきっかけになっている。 5分程度の動画なのでまずみてほしいのだけど、一部暴力的なゲーム内シーンもあるのでこういうのが大丈夫な人は再生ボタンを押してほしい。 www.youtube.com 内容を要約すると以下のような動画になっている。 アンチャーテッド4というゲームは多くの人にゲームを楽しんでもらえるようにアクセシビリティに取り組んでいる これまでのシリーズではボタンを連打するなどの複雑な操作が必要な場面で健常者の助けなしではクリアできなかったが、障がいを抱えたゲーマーの話をきっかけにアクセシビリティに取り組んだ 過

                                                                                  アクセシビリティに興味を持ち始めたきっかけ - ドキュメントを見たほうが早い
                                                                                • 英語で読もう!AWSドキュメント頻出英単語集1900! - ウェルスナビ開発者ブログ

                                                                                  はじめに こんにちは、ウェルスナビでフルスタックエンジニアの水馬です。 みなさんAWS公式ドキュメントは英語で読んでいますでしょうか? もちろん日本語でのドキュメントも充実していますが、一部サービスでは日本語訳に対応していなかったり翻訳が不正確なものも存在します。 Amazon Translate や DeepLのような翻訳ツールを使うこともできますが、やっぱり英語のドキュメントをスラスラ読めるようになりたいですよね! 本記事では、AWS公式ドキュメントで頻出する英単語を頻出順に紹介掲載しています。 ※ 本記事は、AWS DevDay Tokyo 2023 で発表した「英語で読もう!AWSドキュメント頻出英単語集1900!と、その作り方」のRe:Cap記事になります。 英単語帳の詳細についてはこちらの資料をご参照ください。 頻出英単語集1900! はてなブログの文字数上限の都合上、上位20

                                                                                    英語で読もう!AWSドキュメント頻出英単語集1900! - ウェルスナビ開発者ブログ