169 похожих чатов

React — русскоговорящее с... React — русскоговорящее с...
Android Developers Android Developers
Python Python
Vue.js — русскоговорящее ... Vue.js — русскоговорящее ...
supapro.cxx supapro.cxx
DotNetRuChat DotNetRuChat
GNU/Linux Help GNU/Linux Help
Telegram Developers Telegram Developers
Node.js — русскоговорящее... Node.js — русскоговорящее...
DevOps — русскоговорящее ... DevOps — русскоговорящее ...
JavaScript Noobs — сообще... JavaScript Noobs — сообще...
Django [ru] Django [ru]
Go-go! Go-go!
Angular - русскоговорящее... Angular - русскоговорящее...
ntwrk ntwrk
Верстка сайтов HTML/CSS/J... Верстка сайтов HTML/CSS/J...
phpGeeks phpGeeks
Kubernetes — русскоговоря... Kubernetes — русскоговоря...
Битрикс для разработчиков Битрикс для разработчиков
MODX. Русскоязычное сообщ... MODX. Русскоязычное сообщ...
pgsql – PostgreSQL pgsql – PostgreSQL
Laravel Pro Laravel Pro
iOS Developers — русского... iOS Developers — русского...
ClickHouse не тормозит ClickHouse не тормозит
Rust — русскоговорящее со... Rust — русскоговорящее со...
JavaScript — русскоговоря... JavaScript — русскоговоря...
С# С#
pro.cxx pro.cxx
pro.jvm pro.jvm
React Native — русскогово... React Native — русскогово...
Devs Chat Devs Chat
Docker — русскоговорящее ... Docker — русскоговорящее ...
HTML/CSS — русскоговоряще... HTML/CSS — русскоговоряще...
Python beginners Python beginners
🐧 RU.UBUNTU — Официальное... 🐧 RU.UBUNTU — Официальное...
Kotlin Community Kotlin Community
Embedded Group Embedded Group
Чат экстремального погром... Чат экстремального погром...
aiogram aiogram
Scala User Group Scala User Group
Haskell Haskell
PHP PHP
TypeScript TypeScript
Клуб Vue.js-разработчиков Клуб Vue.js-разработчиков
Xamarin Developers (MAUI,... Xamarin Developers (MAUI,...
F# Chat F# Chat
Svelte [svelt] - All abou... Svelte [svelt] - All abou...
Системное администрирован... Системное администрирован...
Nuxt.js | Vue SSR Nuxt.js | Vue SSR
var chat = new Chat(); var chat = new Chat();
Data Science Chat Data Science Chat
Android Architecture Android Architecture
Ассемблер Ассемблер
Laravel для начинающих Laravel для начинающих
Церковь метрик Церковь метрик
Dart & Flutter Dart & Flutter
QA — русскоговорящее сооб... QA — русскоговорящее сооб...
Tarantool Tarantool
pro.elixir pro.elixir
Python Flask Python Flask
SAP ABAP SAP ABAP
R (язык программирования) R (язык программирования)
learn.java learn.java
Big Data Science :: AI / ... Big Data Science :: AI / ...
DevsHelper DevsHelper
SwiftBook SwiftBook
Solidity Development Solidity Development
pro.net (former COM+) pro.net (former COM+)
Delphi & Lazarus Delphi & Lazarus
OpenStreetMap RU OpenStreetMap RU
Visual Studio Code — русс... Visual Studio Code — русс...
ru_mysql ru_mysql
pro.lua pro.lua
GraphQL — русскоговорящее... GraphQL — русскоговорящее...
Evolution CMS развитие и ... Evolution CMS развитие и ...
Dart / Flutter Dart / Flutter
pro.Asm pro.Asm
OpenCartForum - 🇺🇦🇪🇺Чат O... OpenCartForum - 🇺🇦🇪🇺Чат O...
IDE и редакторы — русског... IDE и редакторы — русског...
Angular.js (1.x) — русско... Angular.js (1.x) — русско...
Frontend_ru Frontend_ru
Flutter Developers — русс... Flutter Developers — русс...
AutoIT RU AutoIT RU
AI / Искусственный Интелл... AI / Искусственный Интелл...
Lame C Lame C
Laravel Framework Russian... Laravel Framework Russian...
WebPwnChat WebPwnChat
Чат — Верстка Сайтов и Фр... Чат — Верстка Сайтов и Фр...
pro.python pro.python
dlang.ru dlang.ru
Java Underground Java Underground
Natural Language Processi... Natural Language Processi...
javascript_ru javascript_ru
SqlCom.ru - сообщество MS... SqlCom.ru - сообщество MS...
Cinema 4D Cinema 4D
pro.vim pro.vim
PHP DevConf KZ🇰🇿 PHP DevConf KZ🇰🇿
Delphi Community Delphi Community
Autohotkey_RU ( v1 & v2 ) Autohotkey_RU ( v1 & v2 )
Server Side Swift Develop... Server Side Swift Develop...
pro.rb (Ruby/Rails / RU) pro.rb (Ruby/Rails / RU)
RubyRush.ru RubyRush.ru
Oracle RU Oracle RU
DevOps DevOps
Software Design/Architect... Software Design/Architect...
sql_ninja sql_ninja
Modern::Perl Modern::Perl
Odoo talks & fun Odoo talks & fun
AndroidDev Pro:: Професси... AndroidDev Pro:: Професси...
WordPress for developers WordPress for developers
ru.nim.talks ru.nim.talks
PowerShellRus - о Powersh... PowerShellRus - о Powersh...
Эльбрусы и с чем их едят Эльбрусы и с чем их едят
Java/Kotlin and more Java/Kotlin and more
pro.buildsystems pro.buildsystems
Powershell Rus Powershell Rus
Haskell Start Haskell Start
Python для анализа данных Python для анализа данных
Скрипты Гугл, Таблицы, Go... Скрипты Гугл, Таблицы, Go...
WebGL ru WebGL ru
Compiler Development Compiler Development
firebase_ru — русскоговор... firebase_ru — русскоговор...
phpclub.ru phpclub.ru
ErlangRus ErlangRus
RU.CRYPTOGRAPHY — Криптог... RU.CRYPTOGRAPHY — Криптог...
Electron.js Electron.js
QA juniors QA juniors
GameDev for Web GameDev for Web
MySQL (EN) MySQL (EN)
Go Get A Job Go Get A Job
Lame C++ Lame C++
pro.osdev - os developmen... pro.osdev - os developmen...
RU.Docker — Официальное Р... RU.Docker — Официальное Р...
PostgreSQL (English) PostgreSQL (English)
Emacs — русскоговорящее с... Emacs — русскоговорящее с...
Ember_js Ember_js
FreePascal & Lazarus FreePascal & Lazarus
Tilda Developers Tilda Developers
Django Django
WordPress – русскоговорящ... WordPress – русскоговорящ...
Язык программирования Jul... Язык программирования Jul...
ReasonML и OCaml ReasonML и OCaml
sentry_ru sentry_ru
ansible — русскоговорящее... ansible — русскоговорящее...
WebAssembly — русскоговор... WebAssembly — русскоговор...
Сrystal Lang — русскогово... Сrystal Lang — русскогово...
aiohttp aiohttp
Clojure — русскоговорящее... Clojure — русскоговорящее...
heroku_ru heroku_ru
PowerShell Pro PowerShell Pro
systemd systemd
macOS Developers — русско... macOS Developers — русско...
use Perl or die; use Perl or die;
FORTH и родственные ЯП FORTH и родственные ЯП
ru_jenkins ru_jenkins
Natural Language Processi... Natural Language Processi...
CatBoost CatBoost
CyberBiology CyberBiology
Sequelize - community (en... Sequelize - community (en...
sonarqube_ru sonarqube_ru
Elm Lang сообщество разра... Elm Lang сообщество разра...
SublimeText_RU SublimeText_RU
NativeScript NativeScript
WordPress CodeRun WordPress CodeRun
ReactiveX - русскоговорящ... ReactiveX - русскоговорящ...
PureScript — русскоговоря... PureScript — русскоговоря...
#Вайти #Вайти
Эликсир и Вунш Эликсир и Вунш
Cassandra Cassandra
pro.elixir pro.elixir
Սուրեն-Կիրակոսյան

Кто может помочь советами по "теория написании документации в Elixir"?

Тут вообщем очень простая ситуация:
Есть функция в модуле. Эта функция получает получает параметры и возвращает значение. Если параметров много или мало, то возвращается :error, иначе функция выполнятся. Во время выполнение получение параметры могут не соответствовать условию, в этом случаи так же возвращается :error. Если всё правильно, то возвращается тупл с атомом и мапом. Я посмотрел в нескольких исходниках, в каких-то статьях, но так и до конца не понял: мне стоит описывать каждый случай вызома, скажем с правильным количество параметров и неправильным, с правильными входящими данными и с неправильными, или хватит всего один пример?

Как вы это обычно делаете?

#elixir #programming #russian
0

14 ответов

4 просмотра
Обыкновенный человек-

давай по пунктам: 1. Если передаваемые параметры не соответствуют арности вызываемой ф-ции, то выбросится соответствующее исключение. 2. "не соответствует условию" - речь о guards?

0
18.01.2021
Սուրեն-Կիրակոսյան Автор вопроса
Обыкновенный человек
давай по пунктам: 1. Если передаваемые параметры н...

1. Исключение выбрасывается(в виде атома error), но стоит ли эту часть тоже включать в докементацию? 2. Нет, просто bad requst/invalid inputs, что-то такое.

0
18.01.2021
Anastasiya-Dyachenko

мне обычно хватает spec с перечислением всех возможных результатов, но это подразумевает что ошибки говорят сами за себя, например user_not_found, invalid_id. Если ошибки неоднозначные, то можно в комментарии перечислить все возможные ошибки списком и кратко описать что они значат.

0
18.01.2021
Սուրեն-Կիրակոսյան Автор вопроса
Anastasiya Dyachenko
мне обычно хватает spec с перечислением всех возмо...

Ясно, значит увлекаться с написанием документации не стоит.

0
18.01.2021
Anastasiya-Dyachenko
Սուրեն Կիրակոսյան
Ясно, значит увлекаться с написанием документации ...

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

0
18.01.2021
Սուրեն-Կիրակոսյան Автор вопроса
Обыкновенный человек
👌 очень полезное увлечение.

Я имел ввиду описание многих вариантов вызова этой функции и возвращаемого результата, как это делаем в тестах.

0
18.01.2021
Радж-Полиновский
Anastasiya Dyachenko
не ну если пишешь опен сорс либу то лучше более по...

Есть необходимость ) Потом через полгода, если нужно что-то изменить, смотришь на код как первый раз )))

0
18.01.2021
Anastasiya-Dyachenko
Радж Полиновский
Есть необходимость ) Потом через полгода, если нуж...

если видя внутренности сложно понять что делает код, то код не очень)

0
18.01.2021
Maksim-Lapshin
Anastasiya Dyachenko
если видя внутренности сложно понять что делает ко...

Вопрос не «что делает код», а «зачем» и «какие еще входные параметры тут могут быть»

0
18.01.2021

Похожие вопросы

pro.elixir pro.elixir / Д. П.
Подписаться

А кто-нить эмулировал hackney в тестах? Я хочу сгенерить ответ с client_ref, но что-то ерунду пишу всё время. При ответе он возвращает {:ok..... client_ref}, который надо body...

#elixir #programming #russian
01.08.2023
0
30 ответов
pro.elixir pro.elixir / Ivan Lukov
Подписаться

Впервые код пишу на функциональном языке и кажись я оч плохо это делаю Можете подсказать как получше подойти к написанию такого простенького кода? В целом у меня главная пробл...

#elixir #programming #russian
23.11.2023
0
11 ответов
pro.elixir pro.elixir / heathen
Подписаться

Любопытно, научатся ли эйчары когда-нибудь писать зарплатные вилки в вакансиях? 🔌

#elixir #programming #russian
16.10.2023
0
20 ответов
pro.elixir pro.elixir / Сергій
Подписаться

Кто подскажет, как сделать из макроса метод по умолчанию ? Например что б вот ето работало: defmodule MyLib do defmacro __using__(_opts) do quote do def call(pay...

#elixir #programming #russian
23.08.2023
0
19 ответов
pro.elixir pro.elixir / Vihtor
Подписаться

Коллеги, подскажите, отличается ли как-то принципиально архитектура/паттерны классического SaaS проекта(web app, api, webhooks, periodic jobs, workflows, etc) на Elixir/Phoeni...

#elixir #programming #russian
31.05.2023
0
25 ответов
pro.elixir pro.elixir / Андрій
Подписаться

Привет, стоит ли делать файловый сервер на эликсире на протоколе webDAV или s3? Будет ли он эффективней питона в этом плане?

#elixir #programming #russian
08.11.2023
0
16 ответов
pro.elixir pro.elixir / Alex Georgiev
Подписаться

Ребят, привет! может немного не в тему но все же. Сейчас пишу бэк на питоне, хочу освоить написание бэка еще на каком-нибудь ЯП. Думаю между ruby и elixir. Можете что-то посов...

#elixir #programming #russian
20.07.2023
0
24 ответов
pro.elixir pro.elixir / Дмитрий Перцев
Подписаться

Кто-нибудь, случайно, в курсе, как уменьшить аппетиты BEAM по памяти? А то у меня простое приложение в :erlang.memory(:total) показывает 54877864, а VIRT памяти сжирает 4 гига...

#elixir #programming #russian
29.08.2023
0
21 ответов
pro.elixir pro.elixir / Fried Zucchini
Подписаться

зачем мне его писать если в меке уже всё есть?

#elixir #programming #russian
30.10.2023
0
17 ответов
pro.elixir pro.elixir / Eugene Batogov
Подписаться

Друзья всем привет! Мы снова ищем Elixir-разработчика. Описание вакансии тут: https://hh.ru/vacancy/83458243?hhtmFrom=employer_vacancies&customDomain=1 Кому интересно - откли...

#elixir #programming #russian
17.07.2023
0
22 ответов
Смотреть еще
pro.elixir pro.elixir
Подписаться
Вопросов 9218
Ответов 16773
Участников 1211
Telegram @proelixir

Обсуждают сегодня

Всем привет, написал код ниже, но он выдает сегфолт, в чем причина? #include <stdio.h> #include <stdlib.h> #include <string.h> struct product { char *name; float price; };...
buzz базз
70
Всем доброго дня, ребят подскажите пожалуйста, если в курсе по ассемблеру используется MASM32, могу ли я использовать FASM? В чем явная разница и будет ли у меня все работать?
Botsman
17
Хотел бы спросить у знающих, правильную ли я выбрал книгу для начала изучения ассемблера Юрова В.И ? Или есть более лучшие книги для начала обучения?
Botsman
25
Книга Юрова В.И пойдёт для обучения?
Botsman
24
$params = [ 'formid' => 'feedbackForm', 'formTpl' => '@CODE: <form class="form-validate" data-id="ajax_form"> <fieldset class="margin-bottom-md"> ...
Pathologic
1
Люди добрые, помогите с идеями, потому что свои закончились. У клиента падает софтина в момент инициализации модуля OtlEventMonitor на RegisterWindowMessage('Gp/OtlTaskEvents/...
Михаил Усков
7
> Примечательно, что новый владелец удаляет из GitHub любые жалобы, указывающие на подозрительную активность или смену владельца, и, видимо, рассчитывает на то, что пользовате...
Alex Sherbakov
2
GridView fully ignored first parent(SizedBox), and take width from second parent(Container). How can I constrain GridView by first parent? Widget build(BuildContext context) {...
Hamster
1
Коллеги, добрый день. Есть такой вопрос: Есть модуль, который надо запустить через супервизор как дочерний процесс. Пока инстансов было нужно 8, всё было окей, но когда их ст...
Δημήτηρ
4
Hey there Which is the best Linux destro for developers (coding)? To my research on reddit, they said Linux mint is good for mid level spec and Ubuntu for high Lev hardwar...
Wiz 🪄
11
Карта сайта