Obsah a styl odborných prací
m (Dodán odkaz na práci Míši Švecové a Lucie Bořecké.) |
(Přidáno Co psát...) |
||
| Řádka 1: | Řádka 1: | ||
<div class="Souvisejici">Související stránky: [[Harmonogram projektu]], [[Osnova dokumentace projektu]]</div> | <div class="Souvisejici">Související stránky: [[Harmonogram projektu]], [[Osnova dokumentace projektu]]</div> | ||
[[Category:Maturitní projekt]][[Category:OA]][[Category:VSE]] | [[Category:Maturitní projekt]][[Category:OA]][[Category:VSE]] | ||
| + | |||
| + | == Co psát do dokumentace == | ||
| + | * Co není v dokumentaci, jako byste nedělali. | ||
| + | * Neztrácejte tedy čas obecně známými banalitami, které se najdou na 150 různých fórech. | ||
| + | * Pište to, co jste museli skutečně sami zjistit (vynechte věci, které jste museli zjistit, protože jste už zapomněli, že jste se to učili loni... ;)). | ||
| + | * Pokud jste měsíc řešili problémy s ovladači síťové karty, uveďte je. | ||
| + | ** Nepopisujte ale všechny nepovedené cesty, které nevedly k cíli. | ||
| + | ** Vysvětlete problémy a popište správné řešení. | ||
== Jednoduchý styl, omezení vazeb mezi větami == | == Jednoduchý styl, omezení vazeb mezi větami == | ||
Verze z 18. 3. 2012, 19:40
Obsah |
Co psát do dokumentace
- Co není v dokumentaci, jako byste nedělali.
- Neztrácejte tedy čas obecně známými banalitami, které se najdou na 150 různých fórech.
- Pište to, co jste museli skutečně sami zjistit (vynechte věci, které jste museli zjistit, protože jste už zapomněli, že jste se to učili loni... ;)).
- Pokud jste měsíc řešili problémy s ovladači síťové karty, uveďte je.
- Nepopisujte ale všechny nepovedené cesty, které nevedly k cíli.
- Vysvětlete problémy a popište správné řešení.
Jednoduchý styl, omezení vazeb mezi větami
- Používejte jednoduchý styl, omezte složitost souvětí.
- Snažte se omezit na strohá fakta, vynechte nepotřebné fráze.
- Omezte použití ukazovacích zájmen. Každá věta by měla nést informaci sama o sobě.
Odborné termíny
- Dbejte na správné použití odborných termínů z oblasti, o které píšete.
- Snažte se být konkrétní a přesní.
- Pokud existuje více termínů se stejným významem (synonyma), zvolte vždy jeden a používejte ho v celé práci.
- Při první použití termínu či v místě, kde termín objasňujeme, je možné zmínit i další ekvivalentní termíny (synonyma) pro upřesnění pro čtenáře, kteří by znaly pouze tyto ekvivalentní termíny.
Spisovný jazyk
- Používejte spisovný jazyk, vyhýbejte se hovorovým termínům.
Nadpisy
- Při volbě nadpisů se snažte, aby co nejlépe postihovaly skutečný obsah kapitoly.
- Zároveň by ale nadpisy měly být krátké.
Nepište banality
- Neztrácejte čas popisováním zřejmých věcí! Snažte se vysvětlit věci, které zřejmé nejsou.
Každý vidí, že novou akci vytvoří tlačítkem „Nová akce“ a do kolonky „Titulek“ má napsat název akce. To není třeba komentovat nebo budiž, uveďte, chcete-li.
Vysvětlete ale hlavně, jak do vytvořené akce umístit jednoduše odkaz na fotogalerii z minulého ročníku akce, to možná běžného uživatele nenapadne, zvláště pokud v nabídce žádné tlačítko „Nová fotogalerie“ není a je třeba použít tlačítko „Hypertextový odkaz“ a předtím si z adresního řádku zkopírovat adresu galerie...
Příklad z jiné oblasti: Zabýváme se řazením rychlostních stupňů v automobilu:
Průměrně inteligentního člověka napadne, že když chce zařadit 1. rychlostní stupeň, má řadicí páku posunout k číslu 1.
Je pravda, že by bylo dobré upozornit, že musí mít sešlápnutou spojku, a poradit, kde řadicí páku najde.
Ale i to většina řidičů ví. Vaše práce by asi především měla poradit, v jakých situacích řadit který rychlostní stupeň, že optimálních 2500 otáček za minutu a jak tohoto stavu docílit.
