1 Востаннє редагувалося koala (23.12.2019 10:00:50)

Тема: Декалог програміста-початківця

0. Програміст більшу частину часу читає код, меншу — пише. Спершу думай, потім кодуй.
1. Не бійся переписувати код. Усе одно п.0.
2. Дотримуйся єдиного стилю, стеж за відступами, роби коментарі, це допоможе п.0.
3. Ретельно продумуй назви ідентифікаторів. У (недосяжному) ідеалі код має читатися, як звичайний текст, і не потребувати коментарів. Це допоможе п.0.
4. Не знаєш, як писати далі? Використовуй декомпозицію.
5. Код має працювати. Код, що працює, треба зробити добре читаним. Код, що читається, можна оптимізовувати. Не навпаки.
6. Читай усі доступні довідники, що стосуються твого завдання. Запам'ятати все неможливо; але знати, що в принципі доступно і де його шукати, треба.
7. Роби тести для свого коду. Це допоможе п.0.
8. Використовуй систему контролю версій. Це допоможе п.0.
9. Перед тим, як спитати в інших людей, пошукай в мережі і довідниках. Якщо не знайшов, то детально розпиши, що саме тобі потрібно, і переконайся, що тобі потрібна відповідь на саме це питання. У 90% випадків цього буде достатньо, щоб самому зрозуміти відповідь.

П.С. трохи оновив і змінив послідовність.

Декалог програміста-початківця: https://replace.org.ua/post/132988/

2 Востаннє редагувалося Chemist-i (14.12.2019 22:17:06)

Re: Декалог програміста-початківця

По пункту 5. Я би ще додав про коментування коду, і про те, що (недосяжно) ідеальний код не потребує коментування.

x
Подякували: 221VOLT, koala, reverse2500, ReAl, ostap34PHP5

3

Re: Декалог програміста-початківця

Дякую, доповнив.

Декалог програміста-початківця: https://replace.org.ua/post/132988/
Подякували: Chemist-i1

4

Re: Декалог програміста-початківця

koala написав:

1. Програміст більшу частину часу читає код, меншу — пише. Спершу думай, потім кодуй.
2. Не бійся переписувати код. Все одно п.1.
3. Код має працювати. Код, що працює, має добре читатися. Код, що читається, можна оптимізовувати. Не навпаки.
4. Не знаєш, як писати далі? Використовуй декомпозицію.
5. Ретельно продумуй назви ідентифікаторів. У (недосяжному) ідеалі код має читатися, як звичайний текст, і не потребувати коментарів.
6. Дотримуйся єдиного стилю.
7. Читай усі доступні довідники, що стосуються твого завдання. Запам'ятати все неможливо; але знати, що в принципі доступно і де його шукати, треба.
8. Роби тести для свого коду. Це допоможе п.2.
9. Використовуй систему контролю версій. Це допоможе п.2.
10. Перед тим, як спитати в інших людей, пошукай в мережі. Якщо не знайшов, то детально розпиши, що саме тобі потрібно, і переконайся, що тобі потрібна відповідь на саме це питання. У 90% випадків цього буде достатньо, щоб самому зрозуміти відповідь.

Все так просто але чомусь  як відкриваєш власний код через два місяці. В голові одна думка, що ,курва, робить функція data_processing_thwo(): .

Подякували: ReAl1

5

Re: Декалог програміста-початківця

pluszz написав:

Все так просто але чомусь  як відкриваєш власний код через два місяці. В голові одна думка, що ,курва, робить функція data_processing_thwo(): .

а чого ти не пишеш коментар з описом ?
Генеруй документацію за допомогою Doxygen

- Поганому трояну фаєрвол заважає
- Ніколи не програмуйте та не пийте пиво
Якщо ви з першого разу написали програму, в якій немає жодної помилки, повідомте про це системного програмісту: він виправить помилки в компіляторі
Подякували: leofun011

6

Re: Декалог програміста-початківця

reverse2500 написав:
pluszz написав:

Все так просто але чомусь  як відкриваєш власний код через два місяці. В голові одна думка, що ,курва, робить функція data_processing_thwo(): .

а чого ти не пишеш коментар з описом ?

І сам не раз задаю собі то питання  "Хіба так тяжко було написати чотири слова".

7 Востаннє редагувалося wander (15.12.2019 12:47:53)

Re: Декалог програміста-початківця

Отак тре?)

data_processing_thwo() // data_processing_thwo
Подякували: pluszz, leofun012

8

Re: Декалог програміста-початківця

adziri написав:

Отак тре?)

data_processing_thwo() // data_processing_thwo
data_processing_thwo() // call data_processing_thwo to do the work
Декалог програміста-початківця: https://replace.org.ua/post/132988/
Подякували: leofun011

9

Re: Декалог програміста-початківця

koala написав:
adziri написав:

Отак тре?)

data_processing_thwo() // data_processing_thwo
data_processing_thwo() // call data_processing_thwo to do the work

То би сильно облегшило ситуацію)))))

10

Re: Декалог програміста-початківця

Один час я теж завів собі правило коментувати код англійською (зі словником, бо всієї англійської я ж не знаю), а тоді через кілька років не зміг розшифрувати, що я там накоментив.

py -3 -m pip install git+https://github.com/snoack/python-goto
∩⍴○⌈⍴⍺/∧\∨/⊢○ ⌿⍀⍴⌊
Подякували: Дмитро-Чебурашка1

11

Re: Декалог програміста-початківця

коменти писати важко бо треба переключати клавіатуру
а якщо розкладок на компі кілька то це тапочки

12 Востаннє редагувалося koala (07.02.2020 16:25:25)

Re: Декалог програміста-початківця

monoxrom написав:

коменти писати важко бо треба переключати клавіатуру
а якщо розкладок на компі кілька то це тапочки

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

Декалог програміста-початківця: https://replace.org.ua/post/132988/

13

Re: Декалог програміста-початківця

Ну і ситуації бувають, як казав один мій знайомий а) всякі б) різні, але зазвичай вистачає двох розкладинок - кирилиця і латинка. Різні ў й ü на правому Alt.

Декалог програміста-початківця: https://replace.org.ua/post/132988/
Подякували: leofun01, P.Y.2

14

Re: Декалог програміста-початківця

monoxrom написав:

коменти писати важко бо треба переключати клавіатуру
а якщо розкладок на компі кілька то це тапочки

Tomu treba latynka.

15

Re: Декалог програміста-початківця

monoxrom написав:

коменти писати важко бо треба переключати клавіатуру
а якщо розкладок на компі кілька то це тапочки

Без коментівhttps://replace.org.ua/post/133066/#p133066

16

Re: Декалог програміста-початківця

monoxrom написав:

коменти писати важко бо треба переключати клавіатуру
а якщо розкладок на компі кілька то це тапочки

Двох достатньо (універсальної латиниці й універсальної кирилиці). Звична для більшості українців черга з трьох одномовних розкладок — справді незручно.

py -3 -m pip install git+https://github.com/snoack/python-goto
∩⍴○⌈⍴⍺/∧\∨/⊢○ ⌿⍀⍴⌊

17

Re: Декалог програміста-початківця

dot написав:
monoxrom написав:

коменти писати важко бо треба переключати клавіатуру
а якщо розкладок на компі кілька то це тапочки

Tomu treba latynka.

Латинка — це для бідних людей, що досі пишуть SMS зі старого телефона без підтримки української.

py -3 -m pip install git+https://github.com/snoack/python-goto
∩⍴○⌈⍴⍺/∧\∨/⊢○ ⌿⍀⍴⌊

18

Re: Декалог програміста-початківця

Хтось напише Некролог програміста-закінчивця?

=)