"...ドキュメンテーションが登場すると、エンジニアとしての私にとって、ドキュメンテーションを作成すること自体よりも、そのドキュメンテーションを整理し、見つけることが最も難しい部分です。現在、Cardanoには実際にPlutusに関する多くのドキュメンテーションがありますが、それは12か所も異なる場所に分散しており、どの部分のためにどこに行けばいいのかがわからないのです..." Pi Lanningham - SundaeSwap(https://youtu.be/IfmznLs2ITM?si=twiXsRz2cu4loubX&t=460)
ドキュメンテーションを整理し、見つける問題は、ドキュメンテーションのライフサイクルの一環としてドキュメンテーションの消費者が積極的な役割を果たす場合に、実質的に軽減されます。
Andamioプラットフォームのアーキテクチャ
Andamioオンチェーンバリデータ<-->andamioJSライブラリ<-->Andamioウェブアプリ
は、ReadthedocsやGitBookなどのツールの静的ドキュメントホスティングアプローチを超え、ドキュメンテーションの消費者をドキュメンテーションのアクティブな寄与者にすることで、新しい局面を築くでしょう。
組織にとっての利点:
-
プラットフォームに組み込まれたPBL(Project Based Learning)構造は、システムの基本を提供する方法を提供し、ドキュメンテーションの消費者が寄与者としての役割を果たすことで、すぐにアクションに移ることができます。
-
ドキュメンテーションの更新時間の短縮:寄与者としての役割で、以前は単なるドキュメントの消費者だった人がドキュメンテーションの更新に寄与することができます。
-
組織がAndamioを自分たちの寄与センターにすることで、最も優れたかつ最も活動的な寄与者を検出できる活動計測デバイスが手元にあり、これによりより密接で潜在的に生産的で収益性の高い関係(新しい協力者、新しいクライアントなど)が形成されます。
-
ドキュメンテーションの理解と組み立てに関する難しさは、ドキュメンテーションの消費者が積極的な役割を果たすことから迅速に検出されるでしょう。
この視点から、組織はAndamioをドキュメンテーションをホストするための選択肢として頼ることが奨励されます。
Andamioは世界中の組織を向上させるための文書の足場であり、Cardano上に構築されています。
(興味深い事実:Andamioは「足場」を意味するスペイン語の言葉です。)
Catalyst F11の提案はこちらでご覧いただけます:https://linktr.ee/andamio