Archive for 2007

За писането на документация за Web сайтове/приложения

2007-04-23   

Смята се за съвсем нормално, след като бъде приключен даден сайт (разработка и deployment) на юзерите да бъде даден един кирлив DOC файл с няколко screenshot-а, където е описано криво-ляво как се работи с този сайт или поне с админ панела му.

Всъщност -- въобще не е нормално -- даже и това не се прави. Обикновено някой от разработчиците отива на място в офиса на клиента и обяснява на някой служител или на групичка от служители как се работи. Цъка бързо насам-натам, това тук е за това, онова там за еди какво си, някакви въпроси има ли? Няма? Ами аз ще тръгвам тогава.

Представете си какво могат да разберат и запомнят юзерите от едно такова обучение… Най-вероятно -- почти нищо. После им се сърдим, че били тъпи, разсеяни и т.н.

Та думата тук ми се за писането на документация.

(more…)

Задаващото се PHP6. Какво ново и ще има ли полза?

2007-04-23   

Преди доста време излезе "протокола" от една сбирка в Париж на PHP разработчиците в който се описва какви са идеите за PHP6 (Minutes PHP Developers Meeting) . Този пост ще коментира някои от точките от гледна точка на разработчик, който пише на PHP.

(more…)

За Тангра PHP framework-а

2007-04-11   

Изминаха повече от две години откакто започнах да пиша моя PHP framework.

Ще изминат вероятно още две докато го добутам до public release.

Когато го започвах, честно казано, не мислех, че ще отнеме чак толкова време -- по-скоро бях се настроил "ей сега, още 1-2 месеца и готово". Тия "още 1-2 месеца" обаче си стоят 1-2 откакто се помня (едва ли не) и вече сериозно започва да ми писва. Та се замислих -- "И какво правим сега?!"

Общо взето в подобни ситуации, когато някой проект се забатачи (не че този се е забатачил в обичайния смисъл, просто работата се оказа бая повече от тази, която може да свърши сам човек) сядам и разписвам всички оставащи за вършене таскове, после се опитвам да им дам приоритет и след това ги нахапвам един след друг.

Към настоящия момент списъкът е:

  1. Довършване на сайта и преместването му на tangraframework.net
    1. Редактиране на общите приказки за "какво е", "защо е", история и т.н.
    2. Да се напише един прост news модул
  2. Довършване на API reference (това май ще се окаже най-лесното -- с помоща на phpDocumentor нещата стават доста лесно, макар че кода се пълни с бая излишни като за там коментари, но това е отделна тема, която ще засегна в отделен пост)
  3. Написване на "Quick start" (квик старт :-))
  4. Пакетиране в един общ all-in-one tar.gz/zip
  5. Release 2.0RC1

Това горното го виждам да стане до 1-2 месеца. :-)