長期的なプロジェクトでは、企業アプリケーションのuxおよび設計ガイドラインの一部に取り組んでいます。昨年まで、彼らはファイルサーバーで「静的な」pdfを使用しており、古くなって誰も使用していないため、そのためです。ここに誰かがガイドラインを公開し、定期的に更新するための既存の(時間のかからない)プラットフォームの経験がありますか? AppleおよびMSがガイドラインを公開している形式が好きですが、非常に時間がかかるようです。
これはUXに固有のものではないと思います。これは実際には知識管理の問題です。この種のものには、人々/製品/サービスのエコシステム全体があります。
Confluence、SharePoint、MadCap Flare、Salesforceサイト、GoogleドキュメントなどのWikiなどのソフトウェアはすべて、実行可能なオプションです。セキュリティ(およびその他の)要件によって異なります。
Google: Knowledge Management stackexchange そして興味深いヒットが得られます。
次のような質問をすることで、 プロジェクトを設計するのと同じように成果物を設計する でなければならないというAviva Rosensteinに同意します。
対象者は誰ですか?彼らのニーズは何ですか?何を伝える必要がありますか?彼らの目標は何ですか?
私にとって、私は開発者チームに影響を与えて、ベストプラクティス/企業標準を採用するようにしています。開発者にはやらなければならないことが多く、多くの制約があり、時間もあまりありません。したがって、ガイドラインとして作業コードの提供に焦点を当ててきました。これは、HTMLプロトタイプ内の機能的なJavaScriptで、必要な相互作用パターンを示します。つまり、CSSのルックアンドフィールガイドラインを体系化しています。
これは、ガイドラインに準拠していることを確認するために、 Selenium などのツールを使用してブラウザーベースのUX単体テストケースを開発できることも意味します。ビルドプロセスにこのタイプのテストを含めると、コードベースが変更されるたびにテストが行われ、開発者(およびあなた)は、仕様が満たされていないときに自動的かつ即座に通知を受けることができます。
今スタイルガイドに取り組んでいます。これはHTML形式で、ローカルサーバーで実行されます。 Web上でレンダリングする理由はいくつかあります。1.共有、ナビゲート、検索が非常に簡単です。 2.ユーザーに表示される相互作用と動作を確認できます。 3.コードスニペット-スタイルガイドは、必要な.css、.js、および.htmファイルを提供して使用方法を実証しない限り、開発者にとってあまり役に立ちません。 4.更新が簡単。 OK、サイトレットの更新はWordファイルの変更ほど簡単ではありませんが、強化されたユーティリティを使用すれば、それだけの価値があります。
私がOracleの開発チームの一員として働いていたとき、UXガイドラインを含むすべてのドキュメントはhtmlにする必要があるというポリシーがありました...簡単に共有および編集できるようにするためです。
うまくいきました。
私は通常、UX関連のドキュメントを作成するために Axure を使用します。これにより、Webサイトを非常に簡単に生成でき、UIの対話性を表示して特定の対話パターンを示すこともできます。誰でも簡単にWebサイトにアクセスでき、特定の領域を伝えたい場合は、サイトの特定のページへのリンクを提供することもできます。 UXガイドラインを示す例を試すことができるインタラクティブなガイドを用意することも、ガイドの読者にとっておそらくもっと楽しいでしょう。