- Ez a fejezet, valamint a Műszaki ▒~Mrás teljes tankönyve, a műszaki írás készségeire összpp ontosít.
- Az itt található műszaki tartalom sikeressége, pontossága vagy id▒~Qszerűsége nem garantált.
- Az oldalon található képekben lév▒~Q szöveg fordítása a lehet▒~Q leghamarabb elkészül.
- Kattintson ide, hogy segítsen David McMurrey webtárhelyének költségeit fedezni: Adományozzon bármii lyen összeget! Az Online Technical Writing továbbra is ingyenes marad.
Mi az a white paper?
Számos olyan dokumentumtípus létezik, amely white paperként határozza meg magát. Íme egy meghatározás, amely az alábbi Kapcsolódó információk (Related Information) listájából származik:
A white paper egy technológiai vagy üzleti dokumentum, amely háttérinformációt nyújt egy projektről (eszköz, módszer stb.), és érvel mellette.
A hangsúly az „érvel mellette” (advocates) kifejezésen van — vagyis a white paper valami mellett vagy ellen érvel, és állást foglal egy adott kérdésben (vagy azzal szemben).
A Purdue OWL részletesebb meghatározást ad a white paperről:
|
Mi az a white paper? Eredetileg a white paper kifejezést hivatalos kormányzati jelentés rövid megnevezéseként használták, ami azt jelezte, hogy a dokumentum tekintélyt sugárzó és tájékoztató jellegű. Az írók ezt a műfajt (genre) jellemzően akkor alkalmazzák, amikor egy adott álláspont mellett érvelnek vagy megoldást javasolnak egy problémára, és a saját szervezetükön kívüli közönséget szólítanak meg. Napjainkban a white paperek különösen az interneten váltak népszerű marketingeszközzé a vállalatok számára, mivel sok potenciális ügyfél a weben keres információt. A vállalatok a white papereket arra használják, hogy információt vagy új termékeket kínáljanak olyan megoldásként, amelyek megfelelnek ügyfeleik igényeinek. Forrás: smartsheet.comA white paper célja A white paper célja általában annak bemutatása, hogy egy adott álláspont a legjobb választás, vagy hogy egy bizonyos megoldás a legmegfelelőbb egy adott problémára. Kereskedelmi célú alkalmazás esetén befolyásolhatja a jelenlegi és a leendő ügyfelek döntéshozatali folyamatait. Milyen problémákat szeretnének az olvasók megoldani? A white paper közönsége lehet a nagyközönség vagy több olyan vállalat, amely megoldást keres problémáira vagy szükségleteire. Általában nem ismeri személyesen a közönségét, ellentétben azzal, amikor egy recommendation reportot ír az ügyfelének. Ugyanakkor a meggyőzés érdekében a közönség igényeire kell összpontosítania. Ha képes azokra a problémákra reagálni, amelyeket az olvasók meg szeretnének oldani, el fogják olvasni a white papert a megoldás érdekében. |
Amikor azonban megtekinti Gordon Graham white paper website oldalát, a Purdue OWL meghatározásának egyértelműsége kissé csökken.
A fejezet NotebookLM által készített infografikája
A white paper felismerése
Egyes white paperek kifejezetten white paperként nevezik meg magukat; mások nem. Ehelyett a bevezetőben találhat egy-két olyan árulkodó mondatot, amely jelzi, hogy a dokumentum white paper:
|
A dokumentum célja az alapvető fogalmak és kulcsfontosságú mérőszámok meghatározása,
amelyeket egy blockchain teljesítményének értékelésére kell használni,
majd az eredmények kommunikálása. Ez a dokumentum platformfüggetlen erőforrásként (platform-agnostic resource)
is szolgál a technikai blockchain-fejlesztők és vezetők számára,
akik az iparági szabványos terminológia használata iránt érdeklődnek. — Hyperledger Blockchain Performance Metrics |
A „white papers” kifejezés ebben a részletben egyáltalán nem fordul elő, de egyértelmű, hogy a szerző azt szeretné, hogy „értékeljük egy blockchain teljesítményét, majd kommunikáljuk az eredményeket.”
|
9 bevált gyakorlat (Best Practices) főiskolák és egyetemek számára
az online kurzusértékelésekre való átálláshoz
Ez a white paper új nézőpontot javasol... — Új megközelítés a válaszadási arányokhoz |
Ebben az esetben a bevezető szöveg „white paper”-ként hivatkozik rá, a cím azonban a jól ismert „best practices” kifejezést használja. Olvasóként elvárják tőlünk, hogy kövessük ezeket a bevált gyakorlatokat, ami white paperré teszi a dokumentumot.
|
Hogyan aknázhatja ki ERP-rendszere erejét vonalkódolás (Bar Coding) segítségével — Connectware Solutions, Inc. |
A cím alapján arra számíthatnánk, hogy ez egy útmutató jellegű dokumentum lesz, de nem! Ez egy beszámoló arról, hogyan vezette be egy tricikligyártó vállalat a vonalkódolást (bar coding) az ERP (enterprise resource planning) rendszerében. Ez a white paper kidolgozásának egy egészen más módja!
White paper tervezése
Most, hogy tudjuk, milyen különféle formákat ölthet a white paper, és mi az a közös cél, amely a lényegében rejlik, hogyan írjunk egyet? Számos tartalmi szerkezet működik a white paperek esetében. Íme néhány:
- Probléma > megoldás. Nem ismert kellőképpen, hogy az emberek mennyire hatékonyan tudnak tanulni online környezetben (probléma) > íme egy survey method, amely választ ad erre (megoldás).
- Jó termék > jellemzők. Az Edison 9000E napenergiával és butánnal is működik (jellemző); hagyományos háztartási áramról is üzemeltethető (jellemző); és így tovább.
- Jó folyamat > szakaszok. A blockchain-folyamat ajánlott szakaszai növelik annak megbízhatóságát és hatékonyságát.
- Jó folyamat > előnyök. Az API fejlesztésének bevált gyakorlatai (best practices) azzal kell kezdődjenek, hogy figyelembe vesszük azokat az embereket, akik használni fogják az adott API-t.
- Jó termék > előnyök. Az Edison 9000E kevesebb zajt kelt (előny); megújuló erőforrásokkal működtethető (előny); telepítéséhez nincs szükség villanyszerelőre (előny); és így tovább.
Retorikai stratégiák (Rhetorical Strategies) megfontolása
Mivel a white paper alapvetően valami mellett érvelő dokumentum, természeténél fogva meggyőző (persuasive) jellegű. Ennek megfelelően számíthat arra, hogy megjelennek benne azok az elemek és stratégiák, amelyeket a meggyőzés (persuasion) témakörében tárgyalunk máshol. Kattintson az alábbi hivatkozásokra:
logikai érvek (logical appeals)
érzelmi érvek (emotional appeals)
személyes érvek (personal appeals)
ellenérv (rebuttal)
ellenérvek (counter-arguments)
engedmények (concessions)
Ha megtekinti az alábbi hivatkozásokban szereplő példákat, látni fogja, hogy a white paperek gyakran címlappal kezdődnek, amelyet tartalomjegyzék és bevezetés követ.
Kapcsolódó információk (Related information)
White Paper: Cél és közönség. Purdue OWL
White paper minták. Gordon Graham
White Paper GYIK (FAQ). Gordon Graham
White paper példák. HubSpot.
White paper. Wikipedia
White Paper. Investopedia
Hogyan írjunk kivételes white papert B2B márkánk számára [példák]
20+ white paper példa [Tervezési útmutató + white paper sablonok]
AI-promptok white paperekhez
A checklisták, amelyeket általában nem olvasnak el, némi módosítással AI-promptok forrásaként használhatók. Másolja ki az alábbiakat, illessze be egy AI-rendszerbe, például a Google Gemini-be, és nézze meg, mit hagyhatott ki.
Megjegyzés: A white paperek tartalmára, formátumára, stílusára vagy összetevőire vonatkozó minden hivatkozás megtalálható az online technical-writing tankönyvben.
hamarosan!
Örömmel fogadom gondolatait, reakcióit és kritikáját e fejezettel kapcsolatban: az Ön válasza—David McMurrey.
