Hogyan írjunk cikkeket programozás kezdőknek
Nemrégiben Habré kezdtek megjelenni elég sok cikkek különböző aspektusait programozás, amelyek úgy vannak elhelyezve, mint egy cikket „kezdők”. Eközben csak a kezdők, ezek a cikkek gyakran nem egyértelmű: néha - túl bonyolult, néha -, hogy nem válaszol azokra a kérdésekre, amelyek néha - nehezen megfogható.
Határozza meg a célközönség
Azt hiszem, egyértelmű, hogy annak orientirovannae az emberek különböző szinteken, akkor nézd teljesen más. Azonban a legtöbb cikk jelölni „kezdők” összpontosított, akik ismerik a programozás felületre.
Határozza meg a szükséges alapvető ismeretekkel, hogy megértsék a cikk
Elfogadom, hogy nem olyan nehéz írni az elején valami ilyesmit:
„Ahhoz, hogy megértsük ezt a cikket, az olvasó alapvető ismeretekkel a C:
-, hogy képes legyen lefordítani és futtatni az alkalmazást
- tudni, hogy a szintaxis alaptípus és ellenőrzési struktúrák "
Ez nem egy időigényes, de nagyon hasznos az olvasók. Hidd el, ha elkezd egy cikket, mint ez:
Fordítsuk le a következő kódot:
Az olvasó nem érti, mi szükség van rájuk. Ne felejtsük el, ha még nem tudom, hogyan kell használni a fordító.
Jelentkezés egy cikket, amennyire csak lehet
Jó és az illetékes év - az egyik kulcsa, hogy könnyebb megértése érdekében az anyagot.
Próbálj meg írni az összes kódot teljesen
Láttam cikkeket és könyveket, amelyek eltérő mennyiségű kódot eredményeket. Ez vezet az a tény, hogy nehéz megérteni a kódot az olvasó, nem is beszélve arról, hogy ő nem lehet csak másolja ezt a kódot, és futtatni. Persze, akkor például, hogy írjon a különböző funkciók a különböző listák. Ez egy jó dolog, mert ez megkönnyíti a megértést. De ne darabolja logikailag homogén kódrészletet.
Egy példa a program, amely megjeleníti a «Hello, World»:
Egy példa a program, amely megjeleníti a «Hello, World»:
, amelyre vonatkozik.
Ha meg kell törni a kódot több listát, jó lenne a végén a cikk ismét hozza az összes kód egy lista, vagy akár adni egy linket, ahol lehet letölteni a kódot.
Mindig ellenőrizze kódot, mielőtt behelyezi a cikket
Az olvasó a legkevésbé szeretnénk, hogy üljön vissza, és próbálja megérteni, hogy miért a példa a cikk nem működik.
Ugyanezen okból, ha a kód valahogy függ a környezet és a fordító, adja meg külön-külön.
Az 1-es vonal, mi is a header fájlt. amely tartalmazza az osztályok, függvények és változók szükséges streaming input-output C ++. Mi ezt a fájlt, hogy használja a cout objektum, amely a szabványos kimeneti stream.
4. sor elindítja a funkciót fő - arról a helyről kezdeni a munkát a programunk.
Végül a 6. sorban, mi származik a kifejezés «Helló, világ» szabványos kimenetre cout. Ehhez használja a meglehetősen egyszerű szintaxis üzemben <<. Слева от оператора записывается объект потока (в нашем случае cout), справа — выражение, которое должно быть выведено в этот поток.
Képzelje magát az olvasó helye
Képzeld el, milyen helyen a példák nem nagyon világos, és magyarázza őket részletesen. Ha lusta leírni néhány dolgot, hogy könnyen megtalálhatók az interneten vagy a könyvek, csak adni egy linket egy erőforrás ahol el tudja olvasni róla.
Lehetőleg ne bonyolítsuk a kódot, és ne perfekcionizmus
Ne felejtsük el, írsz egy cikket egy kezdő. Ha teheti kód könnyebben, akkor a legjobb csinálni. Ha azt szeretnénk megmutatni, hogy a kód lehet javítani (még ha ez bonyolult), akkor írj róla után egy egyszerű megoldás. Képzeld el, hogy hogyan működik egy személy az üzemeltető bevallásának, például úgy döntött, hogy írjon egy függvényt, amely összehasonlítja a két szám, és visszaadja a legnagyobb (vagy bármilyen, ha a szám egyenlő). Nem szükséges, hogy írjon valami hasonló
Írj egy egyszerű és világos kódot:
Legyen ez javítható tízszer - nem számít, ha a feladat -, hogy bemutassák a módszer lényege, nem a konkrét megvalósítására.
Megpróbál ragaszkodni az azonos szinten a teljes cikket
Ha elkezd írni egy cikket alapszinten, és a beszélgetés részletesen az egyszerű dolgokat, csináld a legvégén a cikket. Ha a közepén a cikket, akkor hirtelen megáll magyarázni néhány dolgot, az olvasó teljesen elveszti a fonalat a cikket, és összezavarodnak.
Ragaszkodni egy stílust a papír
Nem számít, hogy te vagy a „tudományos” stílus, vagy a stílusa „Most, férfi, lefordítani a teremtés.” Fontos, hogy egyforma, és ne kerüljenek ki a formális és az informális narratív oda-vissza tízszer egy cikket.