Добри практики при писането на домашни


10

Здравейте, джуниър нинджи!

Тъй като забелязах, че някои хора не са много сигурни как трябва да си пишат домашните и какви практики е хубаво да си създадат, написах една малка статия в блога ми по темата: http://kris-it.com/dobri-praktiki-pri-pisaneto-na-domashni/

Надявам се да ви помогне, а ако някой има забележки или нещо за допълнение по темата, с удоволствие ще се радвам да го изслушам :)

Поздрави, Крис.




Отговори



9

Да добавя: номерацията на проектите в рамките на Soulution-а трябва да започва с 0. Т.е. 01, 02, 03, 04... За да се избегне нежеланото подреждане 1, 10, 2. :)
 


от easlavov (4118 точки)


0
Да, аз така съм го направил на screenshot-a, но ще добавя това за пояснение :)

от kris4o1993 (3555 точки)


4
Аз вчера писах в една тема за основните неща, за които трябва да се внимава при оформянето на домашните, но в последствие беше изтрита. Та ще нахвърлям тук стегнато:
1. Всички задачи се поставят в отделни проекти в рамките на една Solution. Ако има тематично свързани задачи се правят в общ проект.
2. Проектите се обозначват с комбинация от думи, която насочва към задачата и съдържа номерът на задачата. Номерът на задачата НЕ трябва да се поставя най-отпред, защото автоматично се добавя долна черта преди него. По този начин името става грозно и не отговаря на конвенциите за именоване. Подходящо е например име като Ex2Hello, Ex3PrintAge и т.н.
3. Program се замества с подходящия текст както в класа, така и в името на съответния .cs-файл.
4. Никъде в програмата не се допуска дискредитиране на анонимността на домашното.
5. В закоментиран блок се копира условието на задачата от съответната презентация. Лично аз предпочитам да е в горната част на кода в класа, където е Main-метода, но понякога съм виждал и да е в долната част под кода. Особено когато условието е дълго.
6. Трябва да е съобразено, че коментарите по кода са предназначени за други програмисти и да не са прекалено подробни и глупави, т.е. да не описват очевидното. Глупав коментар е например "Това е while цикъл"

от ttitto (1950 точки)


0
Подкрепям напълно. Което ме изпълва с нетърпение да проверя кой какво е писал по задача: Modify the application to print your name :)


0
Това не са задължителни правила. Да не вземеш сега да намаляваш оценките на хората, ако са разделили двете задачи!

от ttitto (1950 точки)


6

Една лека вметка и от мен относно именуването на отделните файлове в даден солюшън или по-специално номерацията в началото на имената им. НЕ е толкова добра практика да се използва това номериране, защото самото Visual Studio добавя паразитни символи от рода на тире и точка в името на namespace на самата програма, а това не е добре хич. Пример: ако добавим в даден солюшън проект с име 01. MyFirstProgram, то тогава ще забележите как namespace ще се преименува на _01.MyFirstProgram, като точно тези "_01." са напълно излишни да се съдържат в името на неймспейс-а.

Това което съм виждал многоуважаемите трейнъри да правят е следното:
- първоначално си задават нормално име на даденият проект, като не въвеждат никаква номерация в началото на това име
- след като вече е създаден този проект и името на неймспейса си е напълно коректно, едва тогава вече те добавят и номерацията към самото име от страничното меню /където имаме изглед към отделните проекти/, като по този начин тази номерация вече не повлиява по никакъв начин на името на неймспейса.

Да, знам че в първите 2 курса надали ще се наложи да изполвате неймспейси, но все пак мисля, че ще ви е от полза да го знаете занапред. Така ще намалите риска след време, когато реално започнете да ги използвате от това да търсите и преправяте странните им имена, които са се формирали точно заради този навик да номерираме проектите си.

Поздрави,

Влад


от Vlado_XXX (944 точки)


0
Добавих поправката ти, както и обяснението защо правим така. Благодаря :)

от kris4o1993 (3555 точки)

0
Няма проблем, колега. Радвам се, че бях полезен с нещо, а и нали затова сме тук - да си помагаме взаимно, защото по този начин ние научаваме много нови неща един от друг. Поздравления за блога и успех в Академяита! :]

от Vlado_XXX (944 точки)



1
Искам да попитам за неща от сорта на 10.Provide a short list with information about the most popular programming languages. How do they differ from C#?; 11.Describe the difference between C# and .NET Framework. (от домашното Introduction to programming), включваме ли ги в рар-а, който изпращаме в системата или това си е упражнение само за нас ?

от petrov.peter (32 точки)


0
Това е въпрос, който и аз си задавам. Като се има предвид условието ("Направете списък с..." и "Опишете разликата"), мисля че трябва да има нещо написано, но под каква форма? Ако условието беше "Запознайте се...", би могло да си е само за нас. Моля някой по-зпознат да каже!

от m.tonkov (161 точки)

0
Можете да го добавите написано в текстов файл към архива с домашното или да го напишете като коментар в нов проект в солюшъна на домашното, но доколкото знам, не е задължително.

от desislavaiv (292 точки)



1
Колеги, един въпрос имам.
Някъде преди бях срещнал, че е хубаво преди да архивираме домашните да трием bin и obj папките от всеки проект, но сега не мога да намеря отново тази тема. Някой може ли да потвърди, че се готвя да ъплоудвам :)

от ghgi7 (60 точки)


0
Да, по-добре е да ги махнеш ако искаш да намалиш обема на архива, иначе няма проблем да ги оставиш. :)

от emil.venkov12 (1553 точки)

0
Хубаво е да се махат, visual studio, ще си ги направи само, ако искаш пробвай да ги затриеш, след това си пусни отново проекта, те ще се появят. Но като цяло сека в началото за първите домашни не мисля, че има кои знае какво значение, виж по-натам може и да има(на нас Тренера ни го каза)

от H.Tsekov (769 точки)