Как мне структурировать HTML / CSS / Javascript, чтобы с ним могли работать люди, которые никогда не работали с HTML / CSS / Javascript?

Question

Я работал с HTML / CSS / Javascript + любым серверным кодом (ASP, JSP, PHP, Ruby on Rails) за всю свою инженерную жизнь. Мне действительно не нужна структура, чтобы понять, как что-то работает, чтобы исправить / расширить / улучшить это. Но я не работаю один.

Я работаю с людьми с различными наборами навыков, в том числе с теми, кто никогда не касался (или даже не видел) HTML / CSS / Javascript в своей жизни.

Упрощенное поперечное сечение, чтобы помочь увидеть HTML / CSS / Javascript опыт:

• слой людей, которые никогда не просматривали источник.
• слой людей, которые считают, что проверять элемент - это то же самое, что и источник просмотра.
• слой людей, которые знают, что нужно найти на веб-странице не изображение, не фоновое изображение, поле ввода, объект без флэш-памяти, объект недвижимости, чтобы щелкнуть правой кнопкой мыши меню и затем выбрать «просмотреть источник».

Как мне структурировать HTML / CSS / Javascript так, чтобы люди, которые никогда не работали с HTML / CSS / Javascript, могли получить запрос на функцию, найти фрагменты кода, к которым он обращается, и продолжить?

Что можно сделать и с чего мне начать? Где должен начинаться код? Существуют ли простые и простые правила, которым можно следовать?

Answer 1

HTML-код должен быть в файле html, JavaScript должен быть в файле js и так далее.Таким образом, вы держите весь свой код отдельно.Это означает, что когда такая работа требуется над функцией JavaScript, разработчик будет точно знать, куда идти.Это также означает, что для людей, которые являются новичками в веб-разработке, они будут знать, на каком языке они смотрят.Я надеюсь, что это работает для вас.

Answer 2

Если люди не знают HTML / CSS / Javascript, они должны изучить его, прежде чем работать с этими понятиями.

РЕДАКТИРОВАТЬ:

Это будет зависеть от вашей цели.
Отдельные файлы для каждого типа контента (css / js / html / images) полезны для повышения удобства обслуживания.

Иногда вам нужно будет вставить несколько встроенных CSS / встроенных файлов js, чтобы добиться повышения производительности.

Самое важное, что члены команды следуют соглашению.

Answer 3

Храните ваш CSS и JavaScript в отдельных файлах, где это возможно, так как это поможет программистам, работающим с языками, не основанными на веб-технологиях.

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

Также напишите примерно в два раза больше комментариев, чем вы думаете.

Я недавно перешел с c # на веб-контент, и эти шаги очень помогли бы мне.