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

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

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

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

Декалог програміста-початківця: https://replace.org.ua/post/132988/
Подякували: 221VOLT, bvn, Chemist-i, P.Y., leofun01, pluszz, Arete, ReAl8

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

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

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

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

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(): .

Бери і є'bash'
Подякували: ReAl1

5

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

pluszz написав:

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

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

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

6

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

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

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

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

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

Бери і є'bash'

7 Востаннє редагувалося adziri (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

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

Бери і є'bash'

10

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

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

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