Най-дълъг

16 отговора 0 прегледа
#1

Най-дълъг

коментар в сорс?

Засега личният ми рекорд е тоя джаваскрипт арей чийт-шийт натракан на айпад минито.

I have sold less books on sex than Stephen Hawking has on physics -- Madonna
Отговор
в отговор на evlampi_popdimitrov #2

Re: Най-дълъг

За php има phpdocumentor. Предполагам, че за шаваскрипт има нещо подобно. По принцип коментарите трябва да се пишат пред всяка функция и да спазват определени тагове, за да могат да ги парсват софуери за генериране на документация.

Отговор
в отговор на croesus #3

Re: Най-дълъг

Бате, ти си застинал в края на 20 век.
Никой не го ебе документация генерирана на база коментари, оти никой не я и чете.
Всеки, който напише коментар на функция требва се наказва с десет камшика. това е, друго нема.

*Вадете уя мамка му, вадете уя не го дръжте в гащите да са вмирисва - Сър Стенли Ройс
Отговор
в отговор на Aaron #4

Re: Най-дълъг

Всеки, който напише коментар на функция требва се наказва с десет камшика. това е, друго нема.
Ама хептен сте я подкарали през просото, почнахте да се лашкате в двете крайности. От TDD със 100% unit тестове, до забрана на коментари... Някои шитави методи си искат коментар.

┌∩┐(◣_◢)┌∩┐
Отговор
в отговор на rabin #5

Re: Най-дълъг

Някои шитави методи си искат коментар.

Сега разбра ли защо требва се наказва пишещия коментари на шитави методи или да пояснявам още като за теб?

*Вадете уя мамка му, вадете уя не го дръжте в гащите да са вмирисва - Сър Стенли Ройс
Отговор
в отговор на rabin #6

Re: Най-дълъг

няма предвид забрана на коментарите, а на автоматичното документиране на база коментари (аз също го мразя). за къв чеп ми е такава документация като мога да натисна Ф12 и да прочета същото нещо в сорса?




NE SUTOR ULTRA CREPIDAM
Отговор
в отговор на Aaron #7

Re: Най-дълъг

Аз годишно имам към 30 проекта и си пиша коментари за себе си, защото забравям кое как беше.

Освен това като започна една функция, а не знам как точно ще мутира в бъдеще, подавам параметрите като арей и в коментарите указвам кой ключ какво прави.

Любимия ми конструктор на функция е

public function blah($params = null) {
............


Отговор
в отговор на zaphod #8

Re: Най-дълъг

Може би си зависи от езика. Пхп предразполага към коментари, затова има много тулове, които правят нещо от коментарите. Например в Уърдпрес цялата информация за някакъв плъгин - автор, версия, УРЛ за ъпдейт, компатабилти ... се пише в коментарите. Дори си има шаблон за коментари на нов плъгин и ако не го спазиш, WP не го разпознава като плъгин.

Отговор
в отговор на croesus #9

Re: Най-дълъг

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

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

*Вадете уя мамка му, вадете уя не го дръжте в гащите да са вмирисва - Сър Стенли Ройс
Отговор
в отговор на Aaron #10

Re: Най-дълъг

Имах предвид увъртяна функция. Не може да се избегне това, сложнотията от време на време в сорса.

┌∩┐(◣_◢)┌∩┐
Отговор
в отговор на Aaron #11

Re: Най-дълъг

Хахаха, ти си прост диклофенак бе бате. Забрави ли пак? И коментари ли не пише великия ПРОГРАМИСТ деба. Посочи некой опън сорс проект дето ти е модел за красив код без коментари. Та еба в насрания диклофенак.

Отговор
в отговор на zaphod #12

Re: Най-дълъг

и кво ше разбереш от сорса бе батко, а чети тука сорса да търсиш констрейнти по стека статично [линк]

Отговор
в отговор на SOVlET SMARTASS #13

Re: Най-дълъг

Софчйе, успокой са малко шси докараш високоо кръвно момче

Иначе ме радва много като почнеш да подскачаш като петленце в клуба, държа да го знаеш това

*Вадете уя мамка му, вадете уя не го дръжте в гащите да са вмирисва - Сър Стенли Ройс
Отговор
в отговор на Aaron #14

Re: Най-дълъг

Обяснявай се докторе. Кръвно, фитнес, психология. Каквото имаш в репертоара. Хахаха. Ебати диклофенака.

Отговор
в отговор на evlampi_popdimitrov #15

Re: Най-дълъг

Ае какви са тези отрицателни стойности на индекса? Аз ли нещо не разбирам или ти се подсигуряваш за всички възможни варианти?


... for a brief moment it seemed that rock 'n roll would inherit the earth.
Отговор
в отговор на Beco_ #16

Re: Най-дълъг

Някои от array функциите (например indexOf) приемат и отрицателни индекси и ги интерпретират като length - i, тоест 'броят' от към края.

Рядко се ползва, но го има. Примерно ако имаш масив с некви стойности за месец и искаш да търсиш стойност само в частта за последната седмица, просто шибаш -7 като отправна точка и си свиркаш

I have sold less books on sex than Stephen Hawking has on physics -- Madonna
Отговор
в отговор на evlampi_popdimitrov #17

Re: Най-дълъг

Така съм съгласен, стига и да е добре документирано. :)


... for a brief moment it seemed that rock 'n roll would inherit the earth.
Отговор