И если там логика сложная и куча других модулей, которыми пользуются только внутри этого приложения.

Ну тык для кого док?

Их все тоже документируешь?

Док же для разработчиков и есть

Т.е. всё равно все абсолютно документируешь?

Если для third-party -то им нужен не док, а рест-апи какой-нибудь

https://github.com/agalaframework/agala/blob/develop/lib/conn/conn.ex#L48-L56

Ну я и говорю, коллбэки пропускаю

Но ты в Агалу не смотри

Она плоходокументированная

Но типа Access реализации, handle_call и тыды я уверен можно пропустить

Т.е. ты коммерческий код лучше, чем Open Source документируешь?

Я вот знаю наоборот, что Open Source код обычно в 3-4 раза лучше задокументирован, чем коммерческий.

Я тебе рассказываю как я это вижу

А не как в реальности

А я спрашиваю, как в реальности оно есть.

Хотя, по чесноку, проект который я делаю за деньгу лучше документирую

Потому что в реальности оно так не просто так.

еще и тестирую

Я вот знаю наоборот, что Open Source код обычно в 3-4 раза лучше задокументирован, чем коммерческий.

это значит на месте нет руководителя разработки. я реквесты без комментов и доки не аппрувлю

это значит на месте нет руководителя разработки. я реквесты без комментов и доки не аппрувлю

Вот именно

В Агале то нет код-ревью

А на работе - есть

это значит на месте нет руководителя разработки. я реквесты без комментов и доки не аппрувлю

Везде есть, просто требования к коду, который выставляют на Open Source обычно выше в плане документации.

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

баги фиксить, возвращаться к коду и развивать

Везде есть, просто требования к коду, который выставляют на Open Source обычно выше в плане документации.

Чьи требования то?

Это ж опен-соурс

mit лицуха as-is

и вперед

тут была команда андройдов до меня, они принялись петь эту песню дескать что документировать и так всё очевидно. мне такой подход ваще непонятен. я скорее за формализм - написал от 10 строк - должны быть комментарии. добавил методы - должны быть doc. добавил модуль - внятный moduldoc. а подход про очевидность плавно приводит к нулевой документации

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

https://github.com/elixir-lang/elixir/blob/master/lib/mix/lib/mix/dep.ex#L78-L96

Т.е. Вы документируете как в Elixir-е все коммерческие проекты?

*Как сам Elixir

Все внутренние функции обстоятельно так

нет

end defp get_deps(all_deps, apps) do Enum.filter(all_deps, &(&1.app in apps)) end defp get_children(_all_deps, _seen, []), do: [] defp get_children(all_deps, seen, apps) do children_apps = for %{deps: children} <- get_deps(all_deps, apps), %{app: app} <- children, app not in seen, do: app apps ++ get_children(all_deps, populate_seen(seen, children_apps), children_apps) end defp populate_seen(seen, apps) do Enum.reduce(apps, seen, &MapSet.put(&2, &1)) end

вот эти я бы тоже заставил описать

пускай даже это будет даже тупо и формально

Контексты и сервисы - по строчке где-то плюс спека

Контроллеры - без @doc

нет

Т.е. у вас жёсткие требования к формальщине.

Т.е. у вас жёсткие требования к формальщине.

ага, я так и говорю. лучше к 10 методам напишите ненужный док, чем пропустите к одному нужный

У Дмитрия разумные требования, там где нужно и полезно. Схожее с моим представлением доков.

Интересно, ещё у кого как.

вот например из моего куска не совсем понятно что делает метод populate_seen и зачем он нужен. я не хочу сталкиваться с таким в своих проектах, смотреть контекст и делать (не)верные выводы

вот например из моего куска не совсем понятно что делает метод populate_seen и зачем он нужен. я не хочу сталкиваться с таким в своих проектах, смотреть контекст и делать (не)верные выводы

Т.е. у тебя требования по документации жёсче, чем сам Elixir задокументирован.

вот например из моего куска не совсем понятно что делает метод populate_seen и зачем он нужен. я не хочу сталкиваться с таким в своих проектах, смотреть контекст и делать (не)верные выводы

А у тебя есть Open Source код хотя бы небольшой, который можно посмотреть?

вот например из моего куска не совсем понятно что делает метод populate_seen и зачем он нужен. я не хочу сталкиваться с таким в своих проектах, смотреть контекст и делать (не)верные выводы

Не нашёл у тебя ни одного Open Source контрибьюта, чтобы был reference-ом, как нужно документировать.

привет, кто-нибудь пробовал запускать приложение из post_start хука релиза? все гайды в инете есть только для случая когда само приложение не нужно, или просто запуск приложения из таска

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

ERROR: S client not available

Не нашёл у тебя ни одного Open Source контрибьюта, чтобы был reference-ом, как нужно документировать.

увы. может, на старости лет

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

Я такое делаю через конфигурацию самого верхнего приложения и там уже в зависимости от его конфигурации оно стартует всё, что нужно. Без хуков, без всего, в зависимости от конфигурации и так далее, оно динамически рисует дерево и поэтому даже процессы, которые что-то инициализируют встраиваются в дерево приложения.

Я такое делаю через конфигурацию самого верхнего приложения и там уже в зависимости от его конфигурации оно стартует всё, что нужно. Без хуков, без всего, в зависимости от конфигурации и так далее, оно динамически рисует дерево и поэтому даже процессы, которые что-то инициализируют встраиваются в дерево приложения.

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

Мои сиды определяют, нужно им запускаться или нет. Соответственно, если сиды на половине процесса оборвались и приложение некондиционно завершилось, они продолжат работу или перезапишут при перезапуске, а если все прошло успешно, то не будут делать ничего.

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

Соответственно я могу в любой момент приложение убивать.

Я к такому дизайну пришёл в конечном итоге.

И оно всегда само знает, что нужно делать, не зависимо от того как запускать. А запускается всегда через старт. Это больше engineering-а, но меньше головной боли потом, когда приложение всегда запускается простым старт.

^^^ он пытался. ввел 39, на не прошел

знакомые аватарки у него. давайте впустим, а?

И оно всегда само знает, что нужно делать, не зависимо от того как запускать. А запускается всегда через старт. Это больше engineering-а, но меньше головной боли потом, когда приложение всегда запускается простым старт.

понятно спасибо)

3 попытки же

Как можно не пройти?

Вот ща как раз проверим

Тут явно все 3 попытки будут использованы

Если они работают)

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

Запустить в хуке через app rpc/eval нужный модуль?

Вообще в post_start приложение уже должно быть запущено, вроде

вот почему-то не запущено, не находит процесс по pid, пробовала Application.ensure_all_started(app) - повторно запускает и падает что порт уже занят, еще пробовала Mix.run "app.start" - падает что не поднят миксовский процесс Mix.ProjectStack

Привет, Oksana! Пожалуйста, реши капчу: Вычисли: 22+68=... Осталось попыток: 2 Если не решишь - забаню навеки... Удачи!

Воооот

Работают попыточки!!! Я знал

пффф, таких нужно забривать сразу кто не решает с первого раза

пффф, таких нужно забривать сразу кто не решает с первого раза

не нужно. люди ошибаются

Привет, Aundrea! Пожалуйста, реши капчу: Вычисли: 57+85=... Осталось попыток: 3 Если не решишь - забаню навеки... Удачи!