技術ドキュメントの公開とは?
技術ドキュメントの公開とは、技術資料の置き場が決まっていないという状態を、仕組みで解消することです。poznoteは、この用途に使えるオープンソースのひとつです。複雑な設定を省いて直感的に使える強力なノート作成アプリです。
- ドキュメントの管理
- タスクとToDoリストの整理
- 社内向けのノート共有
- 情報の構造化
- セルフホストによるデータ管理
poznoteを使うと何が変わるのか
poznoteは、煩わしい手間を最小限に抑えながら高度なノート機能を提供します。ドキュメントの管理やタスクの整理、ToDoリストの作成など、幅広い用途に対応しています。Dockerを利用したセルフホストが可能であり、自社環境での運用に適しています。JavaScriptで構築されており、自由度の高いノート作成体験を実現します。
すでに世界で使われている完成品を土台にするので、同じものをゼロから作るより短い期間で済みます。当社は、この土台に対して日本語化、画面や項目の変更、権限、帳票、既存システムとの連携を加えて、御社の業務に合う状態にします。
poznoteの日本語対応(実測)
poznoteの日本語ファイルは1件だけで、実務で使うには日本語化が必要です。
| ライセンス | MIT |
|---|---|
| 主な言語 | JavaScript |
| GitHubスター | 767 |
| 日本語ロケール | 日本語ファイルが一部のみ(1ファイル) |
GitHubの公開ファイル一覧から日本語ロケールの実ファイルを数えた結果です。配布用のビルド成果物は除いています。技術的な詳細はpoznoteのOSS情報にまとめています。
進め方は?
進め方とは、現場を見て対象を決め、動くものを見ていただきながら作り、御社の環境へ導入するまでの流れのことです。書類で仕様を固めてから作る進め方はしません。
1日目(無料)
現場に伺い、いまのやり方を見せていただきます。技術ドキュメントの公開のどこから手を付けるかを決めます。
2〜4日目
poznoteを土台に、御社のPCで目の前で開発します。動くものを見ながらその場で直します。
5日目
御社の環境へ導入し、ソースコードと開発ノウハウをお渡しします。以後は自社で改造できます。
その後
追加の作り込みが必要なら、範囲を決めてあらためてお見積もりします。延長を前提にした進め方はしません。
この方法が向かないのは?
向かないのは、基幹システムの全面刷新や、複数部門にまたがる大規模な仕組みのことです。15時間という枠では作り切れません。また、決まった手順を正確に繰り返すだけの処理は、AIを使わないほうが速く確実です。当社ではその部分は普通のプログラムとして作ります。
技術ドキュメントの公開を、まず15時間で試す
名古屋市内なら、1日3時間×5日間の計15時間・税別15万円で試せます。初日3時間のヒアリングと提案は無料です。御社のPCと御社名義のAIエージェントで目の前で開発するので、作り方ごと社内に残ります。成果物とソースコードはお客様のものです。
AI導入お試し実験を見る 動くデモを先に見る(110,000円〜) poznoteについて相談する技術ドキュメントの公開に使える他のオープンソース
同じ用途に使える土台は他にもあります。ライセンス、日本語対応、規模を比べて選べます。
| 名前 | できること | 日本語 |
|---|---|---|
| BookStack | 社内向けのドキュメント管理やWikiを構築できるプラットフォームです。 | 日本語ファイルあり |
| community | 社内外向けのドキュメント管理と共同編集を可能にするConfluenceの代替ツールです。 | 日本語ファイルが一部のみ |
| gramax | Git管理とMarkdownを活用したドキュメント公開サイトの構築ツールです。 | 日本語ファイルなし |
| CommunityServer | ドキュメント管理やCRMを含む、ビジネス向けの多機能なオフィススイートです。 | 日本語ファイルあり |
| docmost | 社内向けのナレッジ共有やドキュメント管理ができるオープンソースのWikiソフトウェアです。 | 日本語ファイルが一部のみ |