指導基準s for 明示するing 警報s

Owner: Christian Jansen	Last Change: Wednesday, December 28, 2005
Goal of this 文書 These 指導基準s shall help specification authors 明示するing 警報s.
ーするつもりであるd readership Specification authors, specification reviewers (開発 , 質保証／確信 , 使用者 Experience, Documentation)
Feedback: dev@specs.openoffice.org

警報s (this incudes 警告s, Error Messages, Questions) are modal dialogs which 含む／封じ込める the have to 含む／封じ込める the に引き続いて Elements:

An 警報 has to:

明確に示す that something has gone wrong
述べる the problem 明確に and 簡潔に.
推論する／理由: 使用者s want to quickly know what went wrong and how to 直す／買収する，八百長をする it. Be 簡潔な／要約する.
Be polite and do not 非難する the 使用者s
Remember that people are upset when things are going wrong. 扱う／治療する使用者s with 尊敬（する）・点.
推論する／理由: At this 批判的な juncture you can make or break your 未来関係 with them.
Give advice on how to 直す／買収する，八百長をする the problem
Use the language your 的 group understands
Stay away from obscure error codes, abbreviations, technical jargon, or 内部の marketing 条件 unfamiliar to 使用者s. Use simple English.
Don’t make 顧客s guess
Explicitly tell them how to 妨げる repeating an error.

Usage of Icons

Each 警報 has to 供給する an icon. The icon gives （警察などへの）密告，告訴（状） about the type of 警報 and its severity level of the 警報.

Icon	Severity
	Question	Use this icon for 警報s that ask a question. Use question as in normal flow of 操作／手術.
	（警察などへの）密告，告訴（状）	Use this icon for 警報s that 供給する an （警察などへの）密告，告訴（状）. Use this in normal flow of 操作／手術.
	警告	陳列する，発揮する this icon to 通知する that an unusual error occurred
	批判的な	陳列する，発揮する this icon to 通知する that an 批判的な error occurred

Example:

The examples below shall give an idea of a 警告 which got 改善するd from a 貧しく written 警報 to a good one:

Icon	警報 Text	承認する?
	Error saving the 文書 ABC: General Error. General Input/生産（高） error	No Too technical. Language used is for Programmers but not for 使用者s. Wrong type of icon has been selected.
	The 文書 ABC could not be saved, because it is read-only.	No Got 改善するd, but 供給するs no hint to get the problem solved. Wrong type of icon has been selected; severity much too high.
	The 文書 ABC could not be saved, because it is read-only. Try to 除去する the read-only 所有物／資産／財産, or select “Save As...” from the “とじ込み／提出する” menu.	Yes The text is 井戸／弁護士席明確に表すd, gives 使用者s a hint how to get this problem 直す／買収する，八百長をするd. The severity, 示すd by the icon, is 訂正する.

Icon

警報 Text

承認する?

Error saving the 文書 ABC:
General Error.
General Input/生産（高） error

No
Too technical. Language used is for Programmers but not for 使用者s. Wrong type of icon has been selected.

The 文書 ABC could not be saved, because it is read-only.

No
Got 改善するd, but 供給するs no hint to get the problem solved.
Wrong type of icon has been selected; severity much too high.

The 文書 ABC could not be saved, because it is read-only.

Try to 除去する the read-only 所有物／資産／財産, or select “Save As...” from the “とじ込み／提出する” menu.

Yes
The text is 井戸／弁護士席明確に表すd, gives 使用者s a hint how to get this problem 直す／買収する，八百長をするd. The severity, 示すd by the icon, is 訂正する.

文書 History:

改正	Change	初期のs	Date
1	First 草案 created	CJ	July 23, 2005
2	Updated after 査察 of p3386 team	CJ	October 5, 2005
3	改訂するd for OpenOffice.org usage	CJ	December 22, 2005