Skip to content

Записки от учредителната среща на екипа

bonchovylkov edited this page Dec 18, 2017 · 7 revisions

Резюме от началната среща на екипа за JS Basics книгата (https://js-book.softuni.bg)

Използваме като среда за разработка Visual Studio Code: https://code.visualstudio.com

Използваме светла тема във VS Code редактора, защото на хартия тъмният фон изглежда много зле.

Coding standard за JS кода:

Да се използват фиксирани размери на шрифта при code screenshots: 16

Screenshots - Font Size
Запишете "editor.fontSize": 16 в User Settings (шорткът: Ctrl + comma) на Visual Studio Code:

{
    "workbench.colorTheme": "Visual Studio Light",
    "editor.fontSize": 16,
    "jshint.options": {"esversion": 6},
    "editor.tabCompletion": true // за тези, които искат Tab да им допълва кода
}

При въвеждане на масиви, ще четем само елементите на масива, без отделен нулев ред за бройката. Примено, масив от 3 числа се подава по следния начин:

10
20
30

Ще се направи judge contest за всяка тема в този раздел: https://judge.softuni.bg/Contests/#!/List/ByCategory/108/JS-Book. Искаме всички задачи да са тестваеми в judge. Росица има достъп да качва и редактира състезания, задачи и тестове.

Всички сравнения да се правят с ===. Да се спомене, че има и ==, но да се избягва ползването му, защото може да доведе до неочаквано поведение.

Всички стари картинки (за C#) са тук: /assets/images/old-images/chapter.... Новите картинки (за JS) да се слагат в /assets/images/chapter... (без папка old-images)

Пишем issues / review comments и подобни на български език.

Сорс кода от решенията на задачите от всяка глава от JS Basics курса, да се качва тука:

Screenshots:

  • Ползваме Windows 10 стил (по възможност), където има значение.
  • В screenshots се стараем да постигнем големина на шрифта, подобна на текста в книгата.
  • В Paint.net / Photoshop за ограждане на ключови елементи в картинките ползваме color = #00137F, size = 4px.

Видеа за JS курса взимаме от тук:

За чат вътрешно в екипа и всякакви въпроси:

Навсякъде вместо "метод" да се ползва думата "функция".

Ще ползваме стандартен review process в GitHub:

  • Всеки автор работи в свой отделен branch (не в master, той е забранен за commits).
  • Когато е готов, изпраща **pull request **към master branch. Това задейства задължителен review process.
  • Някой друг от екипа прави code review на промените и добавя коментари.
  • По-старшите от екипа одобряват промените след поправените забележки в коментарите.
  • Накрая се налива промените в master branch.
  • Във видеото от първата среща има пример как точно става това.

Линк към видеото от началната среща на екипа (15 декември 2017):

За писане на Markdown, може да се използва VS Code и плъгин: 'Markdown Preview Enhanced' от Yiyi Wang