Budd29 ноя 2009 в 18:40

Стиль кода

1 мин

13K

Python *

Перевод

+44

Комментарии 44

pda1983 29 ноя 2009 в 19:01

По-моему, лучше было бы выложить сюда саму статью, а не ссылку.

Budd 29 ноя 2009 в 19:05

Там больше 10 страниц, примеры разного кода…
Может быть.

pda1983 30 ноя 2009 в 08:11

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

sultee 29 ноя 2009 в 19:09

главное, чтоб через полгода-год статья с того сервера не потерялась)

Budd 29 ноя 2009 в 19:11

Я очень надеюсь. Пожалуйста, посоветуйте, куда можно положить «навечно»? А то я думал-думал…

fata1ex 29 ноя 2009 в 19:14

внешний накопитель :)

fata1ex 29 ноя 2009 в 20:38

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

Budd 29 ноя 2009 в 20:44

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

fata1ex 29 ноя 2009 в 22:09

нет )

sultee 29 ноя 2009 в 19:15

наверно, и правда стоит продублировать текст на хабре (оставив при этом ссылку).
главное, с удобным форматированием )

еще, как вариант, github.com, на котором лежит оригинал статьи.

smsteel 29 ноя 2009 в 19:19

share.auditory.ru/2010/Alex.Smirnov/python_code_styleguide.pdf
Будет лежать «навечно» ;)

dustin 29 ноя 2009 в 21:47

Рядом с
Google C++ Style Guide translated.by/you/google-c-style-guide/into-ru/trans/

zw0rk 30 ноя 2009 в 19:12

гуглдокс? :)

Zubchick 29 ноя 2009 в 19:31

Держите, надеюсь гугл достаточно «навечен».

Budd 29 ноя 2009 в 19:39

Спасибо!

Впрочем, я уже поставил git и даже начал коммитить (раньше использовал только svn) — спасибо, sultee.

sultee 29 ноя 2009 в 19:43

— спасибо, sultee

звучит как упрек :)

Budd 29 ноя 2009 в 19:59

Закоммитил.

Впрочем, оказалось, что еще проще поделиться файлом, просто сделав upload :)

еще копия: cloud.github.com/downloads/DBudd/public/python_code_styleguide.pdf — исключительно в ознакомительных с github целях.

Eltaron 2 фев 2016 в 12:10

Даже не удивительно, что это единственная ссылка, прожившая 6 лет :) Все остальные «выложил навечно» мертвы, причём обычно даже вместе доменным именем.
Спасибо.

Zubchick 2 фев 2016 в 12:32

Amper 29 ноя 2009 в 19:36

Спасибо вам огромное за перевод…

pento 29 ноя 2009 в 19:50

Отличная работа!

jcdenton_dx 29 ноя 2009 в 19:58

Спасибо, автор

tips 29 ноя 2009 в 20:00

Поместите на issuu.com/, дайте тут ссылку и будет всем счастье.

Budd 29 ноя 2009 в 20:06

Хм, скоро по комментариям можно будет писать топик «Десять способов разместить небольшую pdf-ку так, чтобы все могли ее прочитать, и хранилась бы она вечно».

Guria 29 ноя 2009 в 20:46

суффикс ~абель~, хоть и привычен уху компьютерщиков, всё же вполне успешно заменяется более привычным русскому уху ~аем~. В результате из-за слова «читабельный», ваш текст становится менее читаемым.
ЗЫ Кстати в первом же вхождении этого слова пропущена буква

Budd 29 ноя 2009 в 21:03

Букву пропустил, каюсь (и боюсь, что опечаток в тексте больше).

Насчет «читабельный» я спорить не буду, но считаю, что это слово означает не совсем то же самое, что «читаемый», нет? А словари (Ушаков, Ожегов, Ефремова), кстати, не характериуют это слово как жаргонное, разве что пишут о разговорном оттенке.

Guria 29 ноя 2009 в 21:10

Спорить тоже не буду, лишь высказываю свою точку зрения. Давайте попробуем сравнить и понять уместность: «Читабельность имеет значение» против «Читаемость имеет значение»
Лично мне, второе кажется и уместным и более благозвучным. Ваше мнение (а также мнение большинства), естественно, может не совпадать.

Budd 29 ноя 2009 в 21:25

Изменить текст уже поздно :)

Мне казалось, что читаемость чего-то означает «как много и как часто люди читают это», скажем, «За последний год читаемость журнала выросла на треть». А читабельность, как мне кажется, означает то, насколько текст удобно и легко прочесть.

В любом случае, я учту ваше мнение в будущем, спасибо.

Guria 29 ноя 2009 в 21:51

Мне казалось (до сих пор кажется), что «читаемость» — с успехом может означать и то, и другое, в зависимости от контекста. Но коль уж словари говорят, то да — для устранения двусмысленности можно использовать вариант «читабельность», в случае её возникновения.
Ещё пример, с контекстом: «Читаемость этого кода низка из-за несоблюдения рекомендаций по именованию переменных»
ЗЫ Моё мнение подвержено изменению при хорошей аргументации

Guria 29 ноя 2009 в 21:21

А вообще спасибо за отсылку к словарям. Пояндексил. Видимо я зря считал, что суффикс абельность отдаёт иностранщиной. Тем не менее, субъективного ощущения чуждости пока не убавилось.

dsCode 29 ноя 2009 в 20:50

Уже отмечал в предыдущем топике — полезное дело, молодцы ;)

stampoon 29 ноя 2009 в 20:52

дублирую.
85.249.162.69/upload/files/python_code_styleguide.pdf

youROCK 29 ноя 2009 в 20:58

Я тоже:

datapoliten.ru/misc/habr/python_code_styleguide.pdf

Budd 29 ноя 2009 в 21:05

Друзья! Пожалуйста, не нужно больше копий, в этой pdf нет сакральных сведений для потомков!

НЛО прилетело и опубликовало эту надпись здесь

Budd 30 ноя 2009 в 06:46

Простите?

junk 30 ноя 2009 в 08:27

Небольшо довесок тем, кто использует Django

docs.djangoproject.com/en/dev/internals/contributing/#coding-style

zzerf 30 ноя 2009 в 10:56

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