開発者にwikiの使用を依頼する

Question

私は、異なるチームが独自のモジュールである程度重複して作業する複雑なアプリケーションで作業します。メディアウィキのインスタンスがセットアップされている間に、私のプロンプトに部分的に戻ってきました。私は、人々が実際にそれを使用するように働きかけ、難しい仕事をしています。

私は情報を共有することで多くの利益を得ることができます。それは、少なくとも私たちが車輪を再構築する時間を減らすかもしれない。

wikiはあまり構造化されていませんが、必要なものを検索できる限り問題はないとは思いません。

ヒント

Answer 1

私がbeforeと述べたように、Wikiは非常に未編成です。

しかし、それが開発者からの唯一の議論であれば、単純なインデックスページを作成して更新してください（自分で行うか、人々にインデックスへの寄稿者のリンクを依頼する）。このようにして、Wikiはあなたのすべての作業について非常に素晴らしく、非常に包括的なドキュメントのコレクションに成長するかもしれません。

Answer 2

開発者にwikiを使用するアイデアを販売してください。あなたはいくつかの利点を特定し、それらを開発者と共有しました。彼らが価値のあるものを手に入れられることが分かったら、それを使い始めるでしょう。あなたの正式な執筆と編集のためのより多くの時間を与え、迅速なアイデアや長いものを書き留めるための良いWhat Is a Wiki

• から

  例の利点。

• 文書を電子メールで送信せずに即座にコラボレーションし、グループを同期させたままにします。
• ウェブ接続があればどこからでもアクセスできます（ウェブブラウザのテキスト形式で書くのが気にならない場合）。
• アーカイブは、すべてのページのリビジョンが保持されるためです。
• エキサイティングで、即座に、エンパワーする - 誰もが言う。

Answer 3

チームが何度も何度も作成しているような「スティッキーな」アイテム（サブ3pg。docs/diagrams/etc）を見つけてください。& wikiに投稿してください。可能であれば、誰もがwikiにアクセスし、そこにあることを知っていることを確認してください。可能であれば、通知メカニズムを設定してください。いくつかの運があれば、次にバージョンコントロールやマシンからそれを掘り起こすのではなく、アクセスしなければならないときには、wikiを打つべきです。 まだそうでない場合は、チームが実際にwikiを使用するのに十分な余裕があるかどうかを確認してください。サブトラクターの問題は、嫌悪感の下にある可能性があります。

Answer 4

開発者に、使用のインセンティブを持たないものを強制することはできません。残念ながら、ドキュメントのようなwiki（実際には、wiki はドキュメント）は、開発者にとってまれに「クール」な価値があります。しかも、彼らはすでに開発作業に精通しています。あなたは本当にwikiでそれらを気にすることができますか？

言い換えれば、wiki（たとえばあなた）のためにプッシュした人は、主にそれを更新する責任があります。もしあなたが真剣なら、あなたは本当にたくさんの仕事をするでしょう。

あなたはまた、FFを試してみてください：

• それは非常に構造化さていないあなたが言う - 多くの人々は、（ハード・ツー・検索/ブラウズ）病気構造からのWikiをオフにします。だから、最初に修正することができます
• おそらくリード開発者/プロジェクトマネージャーに問題のあるものを入力することができます：特定のプロジェクトのコードコンベンションやAPIデザインのようなもの
• 例を参考にしてください： システムの一部です。先例を設定すると他の人に同じことを勧められるかもしれない

Answer 5

私はいくつかの販売を行い、さらにいくつかのトレーニングセッションを行っています。 WordやOutlookから書式設定されたテキストを貼り付けることができるWYSIWYG編集機能がないと、一部のユーザーが無効になっていると思います。私はこれらを回避するためのツールがいくつかあることを知っていますが、それでもまだ障壁です。

特定の領域を記録するためにwikiが使用されている領域がいくつかありますが、それらを更新する人は何もしません。

便利な脳の拡張機能として機能するにもかかわらず、私は専門領域を文書化するためにwikiを使用します。新しい開発を開始するとき、私はそれが進行するにつれて私が拡大できるアイデアのためのメモ帳としてそれを使用します。

経営者が必須とされていなくても、いくつかの声援を与えるのに役立ちます。

Answer 6

私たちは何らかの形で、あるいはしばらくの間、wikiを使用してきましたが、人々が乗るためにはしばらく時間がかかります。しばらくあなたは唯一の記事を書くだろうが、それに耐えれば、他の人々が最終的に来るだろうということがわかるかもしれない。

誰かが、プロジェクトに関連する情報を含む電子メールを送信した場合、それらを参考にしてwikiの方向に向けると、ヒントが得られるはずです。

私たちはSharePointポータルを持っており、そこからwikiを使用しています。私たちは独自のブランドでカスタマイズして、「見えるように」しています。

wikiが電子メールよりも非公式であることをすべての人が認識していることを確認してください。人々がwikiに追加するものは何も考えられないと考えるかもしれないからです。

Answer 7

これまでの回答の多くは、あなた自身で遠く離れていくほど、役立つ情報の本体が大きくなるので、ゆっくりとしかし確実に人々は自然にそれを使い始めるでしょう。

他のアプローチでは、誰かが他のチームメンバーにプロジェクトに関する質問をするたびに、通常どおり質問に答えるだけでなく、その答えをWikiのセクションに追加することをお勧めします。これには数分かかるかもしれませんが、次回誰かが同じ質問をすると（必然的にそうなるでしょう）、Wikiを指すことで時間を節約できます。これは、人々がWikiを最初の情報源として使い始めることを助け、全体的なアップアップを助けるはずです。

Answer 8

はちょうどここに提供されている優れたアドバイスの一部に追加するには、あなたのWikiの

Answer 9

を育てhttp://www.ikiw.org/のアドバイスを見てみましょう...

6〜24ヶ月の範囲ではほとんど契約していない中小企業の開発者として、私は自分の時間が開発と書面のステータスレポートに分割されていることがよくあります私たちが進むにつれて、組織化されていない思考やメモを叩き落とすためにwikiを持つことは、報告書作成の苦痛を軽減しました（痛みが少なくないが、すべて同じ）。

さらに、既にMediawikiの世界にいる場合は、SemanticMediawikiをご覧ください。データの構成を意味的にタグ付けすることにより、別のレベルにすることができます。それは多くのことを意味するものではありませんが、検索から返されたデータの関連性を大幅に向上させることができます（たとえば）。それは間違いなく一見価値がある。

Answer 10

いくつかのヒント：

誰かが本当にウィキにする必要があります電子メールで情報を送信するたびに、そのトピックのページを作成し、彼らは電子メールに入れたものを追加します。それから、「その情報をありがとう、私はここをwikiに入れて、将来見つけやすくなります」と返信します。

同様に、あなたが共有する必要がある情報がwikiにある場合は、その人物を電子メールで送信するのではなく、そこに置いてリンク先の電子メールを送信してください。

人に情報を求めるときは、そのようなドキュメントをwikiに入れることがデフォルトまたは標準と見なされるべきであると言います。「wikiで検索しましたが見つかりませんでした。まだ？ "

"ウィキチャンピオン"の場合は、他の人にその使用方法を知らせるようにしてください。 「あなたと一緒に新しいページを作成する方法を辿りましたか？」

サイドバーを編集して、自分の作品に関連性があることを確認します。

ナビゲーションを容易にするため、関連ページに「ナビゲーションボックス」スタイルテンプレートを使用します。

フロントページに{{Special：NewPages/5}}のようなものを入れたり、最近の変更を加えて、人々がその活動を見ることができるようにします。

数日または1週間ごとに最近の変更を見て、誰かがプロードされていない情報を追加したことに気づいた場合は、電子メールを送信してください。

Answer 11

私は、人々が実際にそれを使用してもらうのは難しい仕事です。人々がページに寄稿してもらうための最も簡単な方法の

一つは、実際にどのようなことを、彼らはコミュニケーションの彼らの通常のチャネルを使用してポストように、それらはすなわち、ウィキ、適切な方法でコンテンツを提供することです（ニュースグループ、メーリングリストリスト、フォーラム、課題トラッカー、チャット）は、基本的にはwikiへの組み込みに適しています。

他のユーザー（ユーザー/ボランティア）が単にそのようなコンテンツを取り出してwikiに置くことができるようにします。

これは実際にはもっと複雑に聞こえますが、主に質問と回答を一般化することで、必ずしも会話の一部ではありませんが、スタンドアロンの方法ではわかりやすく、意味があり便利です。例えば

次のような質問：

私はリモートリポジトリのクローンを作成するためにgitを得るのですか？

は、次のように答えることができる：

こんにちは、 だけでgitのクローンgitの使用：// ...

しかし、質問にもあまり個人的なスタイルに回答することができます。

gitリポジトリをクローンするには、cloneパラメータをgitに使用します。 git c lone git：// ....

私が言っていることは、プロジェクトのほとんどの議論は最終的に文書化することができます。このような考え方では、ドキュメントは実際にはかなり急速に成長する可能性があります。あなたは、有用な情報がwikiの包含に適した方法で理想的に提供されるべきであるということを心に留めさせる必要があります。

私は、オープンソースプロジェクトがこのアプローチをある程度使い始めたいくつかの例を見てきましたが、一部の人々（主に新しいユーザー）は答えがあまり個人的ではないと訴えていましたが、ドキュメントの本体は着実にそのような議論を監視し、そのような応答をwikiにコピー/ペーストし始めました。

これは基本的に、人々がwikiに貢献するための最も簡単な方法の1つです。実際に自分自身で使用する必要はありませんが、必要なのは思考の変化だけです。

Answer 12

開発者が依然として「本当の」ドキュメント（Word文書）を維持する必要がある場合、私はWiki上でそれを有意義に複製する方法がないと考えています。人々はすぐに、任意の重複データが同期して取得する傾向がある二回

書くことのために

• それは意味がありません。

私の現在の顧客はこれをすべてWikiに移行しています。だから私は一度だけ文書化し、私はを Wikiに掲載しています。

これは問題ありません。 Wikiを使って作業するのはWordより面倒ですが、少なくともドキュメントはオンラインであり、他の人はそれと混じってマッチすることができます。

もう1つの解決策（imho）は、ソースと並んでドキュメントをサブバージョンに保存することです。しかし、併合するシステムは、リッチテキストなどにも対応できる必要があります。私はそれについての解決策が存在するかどうかはわかりません（HTMLまたはLaTexを使用する以外は実際には悪い選択ではありません）。

Answer 13

ここでは一般的に良いアドバイスです。私は追加したい：

1. は、あなたは本当には必要チャンピオン - 誰かの開発者と管理にこれをプッシュ（強引をせず - それは挑戦だ！）と、可能な場合サポート&チュートリアルを提供します。この人物はピア（遠隔地のIT部門の誰かではなく、仲間の開発者）であり、実際に顧客に焦点を当て、すなわち要求されたときに変更を行う準備が必要です。
2. 変更と言えば、のウィキは非構造化です。同意しません。私たちのMediaWikiのインストールは、カテゴリを使って、特に2つの拡張子、すなわち、ページを保存するときにカテゴリを追加することをユーザーに要求するWarnNoCategoriesと、すべてのカテゴリがどのようにフィットするかを示すCategoryTree（サイドバーからリンクできます）あなたが興味を持っているなら、この低いしきい値をどのように保つかについてのヒントがあります。