Ijet Talk

An Introduction to Translating Software Documentation Ryan Ginstrom

What I will talk about today ,[object Object],[object Object],[object Object],[object Object]

Many different types ,[object Object],[object Object]

Readers ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Target: end users vs. developers Load the application in X mode (run also OK) Run the program in X mode X モードでアプリケーションを起動する Deprecated Obsolete 推奨されない Debugging Troubleshooting 不具合の究明 Developers End users

Targets ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

What is good translation? ,[object Object],[object Object],[object Object],[object Object],[object Object]

Honing skills ,[object Object],[object Object],[object Object]

Honing technical knowledge ,[object Object],[object Object],[object Object]

Learn to program! ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Source language ,[object Object],[object Object],[object Object]

Rite away… ,[object Object],[object Object],[object Object],[object Object],[object Object]

Target language ,[object Object],[object Object]

Weaknesses abound ,[object Object],[object Object],[object Object]

We are translators ,[object Object],[object Object],[object Object]

Tools of the trade ,[object Object],[object Object],[object Object],[object Object]

Dictionaries ,[object Object],[object Object],[object Object]

Technical references ,[object Object],[object Object],[object Object],[object Object]

Others… ,[object Object],[object Object]

Technical style guides (online) ,[object Object],[object Object]

Technical style guides (dead trees) ,[object Object],[object Object]

From Microsoft Manual of Style ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

But from Sun’s manual… ,[object Object],[object Object],[object Object],[object Object],[object Object]

Microsoft Manual of Style on Usage Do not use in content for home users or information workers. Use command instead (c.f. メニュー項目 ) menu item Avoid in all content as a verb; use type or another appropriate verb instead. (c.f. 入力 ) input Do not use hint as a heading for a type of note; use tip instead. hint Not PC or machine or box , regardless of audience. computer In general, refer to a button only by its label. Correct: Select the file you want to open and then click OK . button Avoid in content for home users and information workers; use program instead. application

Software ,[object Object],[object Object],[object Object],[object Object]

The good, the bad, and the ugly ,[object Object],[object Object],[object Object]

Exceptional ,[object Object],[object Object],[object Object],[object Object]

UGLY ,[object Object],[object Object],[object Object],例外の発生 : Throw/raise an exception

Use the source, Luke! ,[object Object],[object Object]

BAD ,[object Object],[object Object],[object Object],Don’t be afraid to write English

Count on it ,[object Object],[object Object]

GOOD ,[object Object],[object Object],参照カウント : reference count 1 増加 : increment 1 減少 : decrement

More on exceptions ,[object Object],[object Object],[object Object],[object Object]

UGLY (trick question) ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],Convention!

The dating game ,[object Object],[object Object]

BAD ,[object Object],[object Object],[object Object],データ : File

What’s your destination? ,[object Object],[object Object]

UGLY ,[object Object],[object Object],[object Object],The user just wants to get the job done

More API stuff ,[object Object],[object Object]

BAD ,[object Object],[object Object],[object Object],範囲外 : out of bounds

Ijet Talk

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Ähnlich wie Ijet Talk

Ähnlich wie Ijet Talk (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

Ijet Talk