ドラッグ、ドロップ、完了:ファイルが Archyl ドキュメントへ

誰もが一度は書いたことのある、あのドキュメント。

「添付の図を参照」——添付はどこに?「仕様書を見て」——どの仕様書?「スクショは Slack に貼ったよ」——三週間前。スレッドの中。もう消えている。

別の場所にあるファイルを指し示すだけのドキュメントは、ドキュメントではありません。手がかりが半分むしり取られた宝の地図です。

それも今日で終わり。Archyl のドキュメントは、自分自身のファイルを持てるようになりました。

ドラッグ。ドロップ。完了。

どのドキュメントページでも開いて……そこにファイルをドロップするだけ。クリップボードからスクリーンショットを貼り付けることも。あるいは ファイルを添付 をクリックして、いくつか選ぶことも。

画像はドロップした場所にそのまま埋め込まれます——Markdown と格闘する必要も、画像ホストを探し回る必要もありません。それ以外(PDF、仕様書、エクスポート、誰かが必ず欲しがるあの CSV)は、ページ上部のすっきりした 添付ファイル パネルに収まり、読み手がちゃんと目にできます。

バグのスクショ?インラインで。アーキテクチャのエクスポート?ワンクリックでダウンロード。80 ページのベンダー PDF?それが裏付ける決定のすぐ隣に。

どんなファイルでも。本当に、どんなものでも。

PNG、PDF、Word 文書、ZIP、ログ、設定ファイル——ファイルでありさえすれば歓迎です。「サポートされていない形式」の壁はありません。アップローダーのご機嫌を取るために変換する必要もありません。ドロップして、次へ。(誰かが Blu-ray を添付しようとしないよう、ほどよいサイズ上限はあります——ルールはそれだけ。)

望みどおりの形で保存

ファイルがデータベースを肥大化させることはありません——オブジェクトストレージに保存されます。Archyl Cloud では、それは Google Cloud Storage です:プライベートバケット、既定で保存時暗号化、設定は一切不要。Archyl をセルフホストしている場合は、お使いの S3 互換プロバイダーに向けるだけ——GCS、Amazon S3、MinIO、Cloudflare R2——あなたのインフラ、あなたの判断で。

いずれの場合もバケットは 非公開 のまま。ページは短命の署名付きリンクでファイルを配信するので、機密ドキュメントは機密のまま、公開ドキュメントはそのまま動きます。

ひとことで言えば:速く、安全で、最大のドキュメントでも涼しい顔でさばきます。

なぜ重要なのか

C4 図はシステムがどう形づくられているかを示します。ADR はなぜを記録します。しかしその証拠——スクリーンショット、ベンチマーク、署名済みの契約書、すべての発端となったナプキンの走り書き——は、本来あるべき言葉の隣以外の、あらゆる場所に散らばっていました。

これからは、物語のすべてが一か所に集まります:背景、決定、そしてそれを裏づける証拠が。

十秒で試す

ドキュメントを開く。ファイルをドラッグして放り込む。現れるのを見届ける。

チュートリアルはこれで全部です。

設計ドキュメントは、口先だけであることをやめました。

— Vincent