タグ付けされた質問 「wiki」

私の会社は、市場調査データの管理を改善しようとしています。 現在のデータ管理スタイル： 「ねえ神保、WhatZit 2.0の写真はどこにありますか？ 「ええ、私はその会社からその会社についてのメールを覚えています。数分でOutlookを検索してください」 「重要な競合他社の製品カタログの最新のコピーを持っているのは誰ですか？私のものは2009年からです。」...「コリーンはそうします、そして彼女は産休中です。ワークステーションのパスワードを得るために彼女に電話する必要があります...」 望ましいデータ管理スタイル： トピック（法律、経済、産業、競合他社）ごとに整理されたデータ トピックごとに、複数のメディアタイプ（会社の製品画像、プレスリリース、連絡先情報）が一緒に保存されますが、それでもタイプ別にきちんと並べ替えられます データ編集履歴 共同アクセス（データサイロなし） 私は、すべてのユーザーがアクセスできる部門wikiをセットアップすることを考えていました。上記の4つの基準を満たしているように見えますが、画像ギャラリーや記事の書式設定などのより高度な機能がユーザーフレンドリ（読み方：技術に詳しくない人でも解読可能）であることに少し懸念があります。 ここの誰かが非ITの人々のためにwikiをセットアップし、それが燃えたり、ゴーストタウンになったり、ジオシティのように見えたりしませんでしたか？ おまけの質問：この問題を解決するためにMediaWiki（または他のwiki）を選択した場合、明らかな欠点がありますか？ （私はあなたの何人かが以前にこの問題に遭遇し、いくつかの洞察を提供できることを望んでいます...）

35 documentation  cms  wiki 

閉じた。この質問は意見に基づいています。現在、回答を受け付けていません。 この質問を改善したいですか？この投稿を編集して事実と引用で答えられるように質問を更新してください。 5年前に閉鎖されました。 よく文書化されたソフトウェア開発が成功につながることは誰もが知っています。ただし、通常は、プレーンテキストだけでなくバイナリコンテンツもUML図などのドキュメントに含まれることを意味します。そして、私は多くの人がそれを言うのを聞いたことがあります。バージョン管理システムは、バイナリファイルの適切な場所ではありません。私はこの問題を完全に理解し、同意します。文書を保管するのに最適な場所はどこにあるべきか、何人かのベテランの開発者に尋ねました。Wikiは良いですが、別の潜在的な問題を検討しました。バージョン管理システムに保存されているソースコードは、Wikiの関連ドキュメントにどのように接続できますか？誰かがgitまたはmercurialのリポジトリを複製したとしましょう。彼/彼女はどのようにしてドキュメントを簡単に見つけることができますか？または、私は何かを見逃しましたか？ 一部のウィキシステムには、ソース管理システムと統合する機能があることを知っています。しかし、私の懸念は統合の能力に関するものではありません。gitリポジトリからソースコードのクローンを作成し、しばらくしてから電車に乗って、電車でオフラインで仕事を続けたい場合（これはDVCSの大きな機能です）。次に、電車でオフラインで作業しているため、ドキュメントにアクセスできないことに突然気付きます。一方、ドキュメントがgitリポジトリに保存されている場合、リポジトリが複製されたドキュメントにアクセスできます。

18 documentation  wiki 

私は現在、2つのシステムを使用してコードドキュメントを記述しています（C ++を使用しています）。 Doxygen形式を使用して、メソッドとクラスメンバーに関するドキュメントがコードの横に追加されます。サーバーでは、Doxygenがソースで実行されるため、Webブラウザーで出力を確認できます。 概要ページ（クラスのセット、アプリケーションの構造、サンプルコードなど）がWikiに追加されます。 メンバーやクラスに関するドキュメントはコードに非常に近いため、このアプローチは簡単だと個人的に思いますが、概要ページはWikiで編集するのが非常に簡単です（また、画像、表などを追加するのも簡単です）。Webブラウザを使用すると、両方のドキュメントを表示できます。 私の同僚は、すべてをDoxygenに入れることを提案しています。これは、MicrosoftのHTML WorkShopまたはQt Assistantを使用して、すべてを含む1つの大きなヘルプファイルを作成できるためです。私の懸念は、特に表、画像などを追加する場合、Doxygenスタイルのドキュメントの編集がはるかに難しいことです（Wikiと比較して）（または、生成する必要のないDoxygenの「プレビュー」ツールがありますか？結果を見る前のコード？） 大きなオープンソース（またはクローズドソース）プロジェクトは、コードド​​キュメントを書くために何を使用しますか？彼らはこれをDoxygenスタイルとWikiに分けていますか？または、別のシステムを使用していますか？ ドキュメントを公開する最も適切な方法は何ですか？Webサーバー/ブラウザ経由、または大きな（数MBの）ヘルプファイル経由？ コードドキュメントを作成するとき、どのアプローチを取りますか？

13 documentation  documentation-generation  wiki 

現在のところ、この質問はQ＆A形式には適していません。回答は事実、参考文献、専門知識によって裏付けられると期待していますが、この質問は、議論、議論、投票、または拡張ディスカッションを求める可能性があります。この質問を改善でき、再開できると思われる場合は、ヘルプセンターにアクセスしてください。 7年前休業。 ソフトウェアプロジェクトの仕様とドキュメントを作成および管理するためのwikiまたはwikiのようなシステムを探しています。 利用可能なwiki実装がたくさんあることは知っていますが、この種のタスクに特に適しているものはありますか？ 実際、それはwikiである必要はなく、仕様とドキュメントを簡単に記述してナビゲートし、変更の追跡をサポートするシステムにすぎません。

9 specifications  wiki 

要件管理を改善する方法を検討しています。現在、Word文書をWebサイトで公開しています。残念ながら、（私の知る限り）あるリビジョンから次のリビジョンへの変更を確認することはできません。私は、wikiやVCSのように（または両方がbitbucket上のwikiのように！）できるようにしたいのですが。 また、各ドキュメントは、開発者が所定の期限までに満たすことが期待される変更について説明しています。蓄積されたアプリ機能のコレクションはどこにも文書化されていないため、レガシーアプリをすばやく修正しようとすると、バグと（設計が不十分な）機能を区別するのが難しい場合があります。 だから私はフィードバックを得たいと思っていました。何について： 誰がいつ何を変更したかを追跡できるようにwikiを使用します（ほとんどの場合、前回の表示以降に編集が行われたかどうかを確認するためにも）。 たとえば、期限ごとではなく製品ごとに1つのwikiページを用意し、実装すべき変更ではなく製品のすべての機能に対応します。このようにして、ページの特定のリビジョンを確認して、特定の時点でアプリが何をすべきかを確認できます。また、次の期限までに要件を実装するための最後のリリース以降のページの変更を確認できます 。 ワダヤシンク？

9 documentation  project-management  wiki  requirements 

休業。この質問には、より焦点を当てる必要があります。現在、回答を受け付けていません。 この質問を改善してみませんか？質問を更新して、この投稿を編集するだけで1つの問題に焦点を当てます。 5年前休業。 開発者向けのWikiを設定するためのベストプラクティス構造をお探しですか？ ドキュメンテーション、コミュニケーション、知識共有の実績がまだないチームを管理します。チームがこの領域を簡単に始められるように、フレームワークを設定したいのですが。

9 wiki