jkondoの日記

2004-10-24

はじめまして 10:36

はてなの近藤です。id:sugioさん、id:yukattiさん、参加承認有難うございました。よろしくお願いします。

はてな内では、ダイアリーヘルプの作成やはてなダイアリー日記の主な告知を担当しています。

guideグループでの活動について 10:49

背景

  • 昨日、10月23日にはてなダイアリーヘルプhttp://d.hatena.ne.jp/help)の再編作業に着手しました
  • 2週間ほど、11月5日くらいまでを「はてなダイアリーヘルプ強化期間」とし、ヘルプの改善作業を行いたいと思います
    • このプロジェクトは主に近藤が担当します
    • 現在のヘルプで問題点と考えているのは以下の点です
      1. 長すぎる(巻物になっている、読む気が起きない)
      2. 全体の構成がごちゃごちゃしてきている(機能追加のたびに付け加えているので、全体の構成が崩れている)
      3. ガイドへの誘導が少ない(ガイド内に多くの有益な情報が存在するのに、連携ができていない)
      4. 見出しが「pvモジュール」などとなっており、何ができるのかすぐに分からない
  • 期間は2週間を考えていますが、作業の進捗によって若干短くも、長くもなる可能性があります
  • 作業完了後は、この日記更新は途絶えると思います

guideグループでの目的

  1. 2.の「全体の構成を考え直す」を行うにあたり、すでにガイドでドキュメント整備を行われている皆様からアドバイス等をいただければと思います
    • 少しずつ変更を行っていますので、横から茶々を入れて頂ければ幸いです
  2. 上記3.を解決するため、関連するガイドの項目へのリンクを積極的に追加していきたいと思っています
    • 当グループにて、関連するガイドページの情報等を共有させていただき、リンクのご提案等を頂ければと思います

新しいヘルプの構成について 10:56

以前から「ヘルプが読みにくい」「もう少し整理して欲しい」といったご要望を頂いておりました。

この問題を解決するために、

  1. helpグループを作成し、キーワードヘルプ文書を管理
  2. これまで通りhtmlファイルとし、章ごとにファイルを分ける

といった方法での再編を検討してきました。

しかし、いずれにしても 目次→各項目の詳細ヘルプ という構成となり、ドキュメント数が増大することは避けられないと考えました。

ドキュメントが増大することについては、

の2点の問題があり、なかなか着手できていませんでした。

こうした中、javascript/DHTMLの活用により、「目次とドキュメントを兼ねたヘルプ」という手法に行きつき、社内でのドキュメント整備と、見通しの良い構成が両立できないかと考えました。

昨日変更を行ったヘルプは、「タイトルのみ」「タイトル見出しのみ」を表示させることで、目次のように機能させることができ、必要な箇所をクリックして詳細な情報を読むこともができます。

http://d.hatena.ne.jp/help

当面、この方針でのヘルプ整備を行って行きたいと思います。

画像提供のお願い 11:06

ヘルプからはてなダイアリーガイドへのリンクを作成するに当たり、

キーワードにできる言葉

キーワードの説明には、なるべく普遍的な情報を入力してください。また、キーワードについての説明は誰でも編集する事ができます。キーワードが作成されると、自分の日記だけでなく、他の人の日記内のキーワードも自動的にリンクになります。 →(ガイド画像

みたいな形で、ガイドへの誘導を行いたいと思いますが、ここに使える画像を頂けないでしょうか→id:sugioさん

顔のマークの小さいのがいいのかな、などとイメージしています。大きさは25px角くらいかと思っています。