Документування front-end

Віталька web-systems

Поговоримо про1. Документацію(що це таке і з чим його їдять);2. Навіщо вона нам?3. Розглянемо інструменти для документації;4. Ну і трошки практики

Документація - це- список документів які дають інформацію для розробки, підтримки і

ремонту веб додатків.

Навіщо..?

● Рутинна робота(повторна верстка, лишня робота, погана якість);● Back-end;● Дизайн;● Команда(обмін кодом, комунікація, єдиний стиль);

Проблеми front-end розробника

<?php ….● Я тут трішки поправив...

● .class .class .class ... { }

● !important

● #red_color_aydishnick{}

● .q{}

Документація зробить -1. допоможе згадати те що писали місяць+ тому2. нова людина зможе з легкістю ввійти в проект3. ми не будемо трати час щоб пояснити новому верстальщику що і як у

нас на проекті, гарна документація зробить це за нас4. ну і ви отримаєте багато вдячних людей які будутьвдячні вам до

останніх днів життя цього проекту

HTML

CSS

JS

Чим документувати?● Bootstrap DOC● Source● jekyll● patternlab● GitHub

SourceLiving Style Guide Platform

Source вирішує проблеми з:

● Розробленням верстки● Підтримкою і розробкою документації блоків● Розробки інтерфейсів в команді

Трохи прикладів

ПосиланняSourceDocument-BootstrapPaternLabJekkyl DocСтворення руководства по стилюПризентація Source

Дякую за увагуSkype: vitalka181094E-mail: kriskov.vitaliy@gmail.com