Zamiki pri pisanju kode

glede php ... odvisno, enovrstičnice delam, ko je kaka stvar, ki je več nebom spreminjal in je dokaj preprosta in se mi zdi brezveze tratiti za njo 10 vrstic, ker vem da je več nebom pogledal, pa še običajno gre kot sem že rekel za preproste zadeve ...

To je pa ena najvecjih cvetk, ki sem jo slisal od programerja in je skregana z vsemi pravili lepega programiranja, ki jo ucijo vsepovsod. Meni so tipili v glavo, da je bolje kaksna vrstica komentarja vec kot manj in se tega tudi drzim. Cetudi pisem samo code snippet ali testno kodo, vedno pisem tako, da bom za pet mesecev ko bom to cisto slucajno pogledal, tocno vedel za kaj se gre. Pa cetudi jo nikoli vec ne bom spreminjal.

Se pravi da vsaka zadeva, ki jo napisem zgleda priblizno takole ...

/**

     * Authenticate user

     *

     * @param string $username

     * @param string $password

     * @return Zend_Auth_Result

     */

    public function authenticate($username, $password)

    {

        // Username cannot be empty (db auth adapter throws exception)

        if (!$username) {

            $username = md5('Donec dictum, massa quis ultrices.');

        } else if ($password === null) {

            $password = '';

        }



        // Get Auth object

        $auth = Zend_Auth::getInstance();

        /** ... */

   }

Ce imas namene ostati v tem biznisu, ti priporocam da pises kodo cimbolj pregledno in strukturirano, ter obvezno uporabljaj DocBlock, saj bo slej ko prej kaksen tvoj izdelek prisel v roke kakega znalca, ki bo enostavno zavrnil projekt, ker ga zaradi nepreglednosti kode, ne bo mogoce vzdrzevati.

Prijateljski nasvet, brez zamere :)

To je še kako res! Zadnjič sem si pulil lase, ker sem pred parimi meseci odlašal in odlašal, na koncu pa delal na kolikor hitro se je le dalo in v tej naglici izpuščal vsakršno komentiranje in strukturiranje kode. Nočna mora je bilo potem razvijati s to kodo naprej. :(

Hja hja ...

Nah jaz komendatrjev skoraj ne pišem, kodo pregledno ... komentarje pa zelo redko ...

Sicer pa zadeva ni tako neberljiva če spremenljivke, funkcije ... pametno poimenuješ ...

Hja hja ...

Nah jaz komendatrjev skoraj ne pišem, kodo pregledno ... komentarje pa zelo redko ...

Sicer pa zadeva ni tako neberljiva če spremenljivke, funkcije ... pametno poimenuješ ...

Komentarji so itak namenjeni samemu programerju. Meni osebno je bolj pomembno da ne pozabim dokumentirat vsak class, metodo, spremenljivko ... z DocBlock sintakso, da lahko potem s pomocjo phpDocumentorjem generiram API.

Vsakemu zacetniku se zdi to odvec, ampak ko se navadis, gre kar hitro. Nekateri IDE-ji pa so ze tako pamenti, da ti nad funkcijo sami zgenerirajo ustrezno sintakso za opis vhodnih, izhodinih parametrov.

Ce ne bi tega pisal bi si lahko cez 2 tedna, vse lase populil (ki ji itak nimam), preden bi ugotovil kaksnega tipa so vhodni parametri in kaj metoda vraca.

public function inheritsRole($role, $inherit, $onlyParents = false)

    {

        return $this->_getRoleRegistry()->inherits($role, $inherit, $onlyParents = false);

    }

:)