[0.0.1a] Первый вариант документа #1
Conversation
| "hello": "world", | ||
| "some_internal_dict": { | ||
| "some": "key", | ||
| "another": "key" |
There was a problem hiding this comment.
Добавь запятые после последнего поля. Мы вроде в своё время сошлись, что так делаем.
Также учтены замечания Василия Чинарева
| одного нижнего подчеркивания. | ||
|
|
||
|
|
||
| Lambda-функции |
There was a problem hiding this comment.
Где-то кто-то писал про лямбды, что лучше их всегда переписывать в обыкновенные функции.
Что-то похожее на pep было, надо бы поискать.
There was a problem hiding this comment.
Хотя простейшие функции, описанные в этом разделе документации, как мне кажется, допустить можно.
There was a problem hiding this comment.
Согласно PEP 8 они не должны быть присвоены переменной, т.е. должны быть целиком и полностью инлайновыми в рамках окружающего выражения.
|
Помимо главы про настройку Flake8 можно будет еще добавить главу про настройку isort. |
|
Ну и раз зашла речь о настройках, то и главу про настройку Sphinx :) |
|
Настройки для Flake8 и isort я приведу в конце, ибо они влияют на стиль кода. Настройки Sphinx по вышеуказанной причине приводить не имеет смысла. |
|
|
||
| В случае необходимости разрешается перенос строк (string) с использованием | ||
| тройных кавычек, если это не противоречит логике кода либо использование | ||
| объявления строк в пределах круглых скобок, например: |
There was a problem hiding this comment.
Фраза построена неверно.
А с многострочными строками надо крайне осторожно...
No description provided.