шутка

это типичный успешный предприниматель

и в целом он прав

если ты не программист

всё проще. у магаза не такая большая модель чтобы там было так трудно разобраться

то знать как все работает не надо

да ещё и с такими подробными доками как у меня

типичный доменный эксперт

но и учить программистов как делать тоже не надо

все твои идеи хуита для программистов

код должен быть красивым и лаконичным

и так делать не стоит

я просто в пхп страдаю от этого

всё проще. у магаза не такая большая модель чтобы там было так трудно разобраться

я никогда не забуду, как один чувак "запилил крутую систему скидок"

то что документация проекту

это плюс

но сделана она через жопу

я даже знаю одну методологию

на хабре ее минусовали

да скроллить между тоннами /**/ значительно удобнее, бесспорно

https://habrahabr.ru/post/323132/

почитай

просто есть комммьюнити. оно решило так. и всем уже прикипело

это каак раз то о чем ты говоришь там наверно твои единоммышленники)

да скроллить между тоннами /**/ значительно удобнее, бесспорно

в гадких джава-иде есть удобные инструменты для этого

не факт что это удобно для всех, мне вот нифига неудобно привыкать к тому что в тексте мне какое-то IDE помогает

в гадких джава-иде есть удобные инструменты для этого

notepad++ же

я в Sublime

в гадких джава-иде есть удобные инструменты для этого

в саблайме тоже должны быть возможности удобной навигации по коду, с плагином наверное только

тогда у меня реально крутой и трудный вопрос

почему если код разделяют на конкретные структуры данных (не просто текст, а секции комментов, возвразаемые значения и проч., ну вы поняли) все пишут в текстовых файлах

почему нету универсального формата КОД

file.code

где внутри удобно бы хранились все штуки

чтобы не прыгать

их может было бы даже проще и удобнее парсить тем же grep

и читать доку если она понадобилась

но ты не поймешь

не очень понятно про универсальный формат

вы издеваетесь? для прыжков специально же сделаны IDE (go to и т.п.)

он не знает что phpdoc может генерировать доку в отдельный фаил

хотя про формат есть стабильный многовековой анекдот про 10 конкурирующих стандартов

без кода

а только доку оставлять

почему если код разделяют на конкретные структуры данных (не просто текст, а секции комментов, возвразаемые значения и проч., ну вы поняли) все пишут в текстовых файлах

потому что он есть

когда ты пишешь phpdoc к методу например

универсальный формат. есть структура, общего назначения. предназначенииая для хранения кода. (любого, за исключением языков с сильными отличиями, типа brainfuck )

ты можешь одной командой сделать отдельно доку

есть поля заголовка

например

в которой будет написан класс

и все его методы

и что им можно передать

header - author - version base script section - definition block - definition block - function block - function block - function block - function block

внутри function block -возвр. знач., идент фции тайпхинты

с самого начала блока function - комменты всякие

выглядит то что я читаю давно уже ужасно убого даже с подсветкой

и неудобно

внутри function block -возвр. знач., идент фции тайпхинты

потому что это не нужно тебе ide и так подсказывает return value в ф-ции, какой тип ждет и тд

Может глупый вопрос, но смысл в php 7.1+ phpdoc(кроме случаев аля __get или @var Client[]), если есть нативные тайпхинты?

хотя кода дофига, люди стараются, но всё-равно мрак

тебе не нужно поглядывать в PHPDoc в 90% случаев)

header - author - version base script section - definition block - definition block - function block - function block - function block - function block

немного похоже на описание исходников на эрланге :)

"Мф

@Enapiuz посмотрю)

вот пример

ERROR: S client not available

http://www.doctrine-project.org/api/orm/2.5/class-Doctrine.ORM.EntityManager.html

документации на основе phpdoc

оооооо да

всех методов класса

это верх п....здеца

я видел доктрину и охренел от издевательства

твоя дока по сравнению с этим

надо же додуматься структуры ОПИСЫВАТЬ В КОММЕНТАХ!

нифига ничего не говорит

причем тут доктрина?

колонку добавить и будет говорить

и да, подтверждаю, что даже не 90%, а как минимум 95% времени ты в пхпдок не смотришь, ибо иде сама за тобой следит

да с ним все ясно

пусть на стартап форумы валит

это всё-равно более системно хранится будет чем куча байт строковых, разделённых лишь crlf которые даже в разных осях разные

и с такими же пидорками общается

это всё-равно более системно хранится будет чем куча байт строковых, разделённых лишь crlf которые даже в разных осях разные

в компиляторах/интерпретаторах это давно не проблема

вот, ещё олень с PHP club нарисовался =\

явно верстальщик..

??

забаньте его )

походу угадал

помойму он показал свой професионализм

чё за трололо?

просто это, чувак, ты говоришь, что ты менеджер больше, зачем ты погромистов учишь тогда?

этому никогда никто не будет рад

хз я никого не трогал припёрся чёрт начал орать махать несуществующим у него банхаммером ))

хз я никого не трогал припёрся чёрт начал орать махать несуществующим у него банхаммером ))

переход на личности бро

лесом, бро и я тебе не бро, бро

ты пытаешься нас убедить в том, что твой подход единственно верный, что доки надо хранить не так, как это делается сейчас, оно не просто так делается, так удобно

и те, кто предпочитает не пользоваться нормальными инструментами, либо приручать более простые должны страдать

он пришел ничего не зная