home.md

-# Добро пожаловать в Wiki
+# Добро пожаловать в Репозиторий с документацией
 
-## Здесь представлена вся документация
 
 [[_TOC_]]  
 
-> Можно все искать на панели там-------------------------------------------------------------------------------------->
+## Здесь представлена вся документация и полезные инструкции
+
+Приветвуем Вас в нашей компании!\
+Этот репозиторий был создан для настройки корректной работы как самого GItLab, так и сторонных сервисов так или иначе интегрированных в него.
+
+-----
+
+## Для новых пользователей
+
+В этом разделе указаны советы и некоторые утановки, которые помогут Вашей комфортной и стабильной работе в GitLab ~~и возможно здесь будет что-то еще~~
+
+- В первую очередь настроем свой профиль GitLab:
+
+  - На главной панели (сверху) нажимаем на иконку пользователя, где выбираем "Edit Profile"
+  - Указываем свои личные данные
+  - Выбираем соответсвующий часовой пояс
+  - 
+  - 
+  - Сохраняем изменения, нажимав вниз "Update profile settings"
 
 -----
 
-### Руководство по установке и настройке Jenkins
+## Руководство по установке и настройке Jenkins
 
 Надо написать какой-то комментарий к этой статье
 
+**Jenkins** — программная система с открытым исходным кодом на Java, предназначенная для обеспечения процесса непрерывной интеграции программного обеспечения. Он является чрезвычайно расширяемой системой из-за внушительной экосистемы разнообразных плагинов. Настройка пайплайна осуществляется в декларативном или императивном стиле на языке Groovy, а сам файл конфигурации (Jenkinsfile) располагается в системе контроля версий вместе с исходным кодом.\
+**Jenkins Pipeline** — набор плагинов, позволяющий определить жизненный цикл сборки и доставки приложения как код. Он представляет собой Groovy-скрипт с использованием Jenkins Pipeline DSL и хранится стандартно в системе контроля версий.
+
+Существует два способа описания пайплайнов — скриптовый и декларативный.
+
+1. Скриптовый
+```groovy
+node {
+  stage('Example') {
+      try {
+          sh 'exit 1'
+      }
+      catch (exc) {
+          throw exc
+      }
+  }
+}
+```
+
+
+2. Декларативный
+```groovy
+pipeline {
+  agent any
+  stages {
+      stage("Stage name") {
+          steps {}
+      }
+  }
+}
+```
+
+> Литература для ознакомления с [синтаксисом](https://www.jenkins.io/doc/book/pipeline/syntax/) и [шагами](https://www.jenkins.io/doc/pipeline/steps/)
+
+Они оба имеют структуру, но в скриптовом она вольная — достаточно указать, на каком слейве запускаться (node), и стадию сборки (stage), а также написать Groovy-код для запуска атомарных степов.
+
+Декларативный пайплайн определен более жестко, и, соответственно, его структура читается лучше.
+
+
 [Страница с руководством по установке и настройке Jenkins](Страница-с-руководством-по-установке-и-настройке-Jenkins)
 
 -----
 
-### Новое руководство ?????
+## Новое руководство ?????
 
 Здесь будет новое руководство *Вероятно будут разъяснения по коду Jenkins*
 
@@ -37,4 +93,4 @@
 -----
 
 -----
-[Возврат к Содержанию](home#содержание)  |  [Открыть страницу заново](home)  |  [Руководство по установке и настройке Jenkins](Страница-с-руководством-по-установке-и-настройке-Jenkins)
+[Возврат к Содержанию](README.md#содержание)  |  [Открыть страницу Home](https://gitlab.mega-pol.ru/Documentation/Guides/-/wikis/home)  |  [Руководство по установке и настройке Jenkins](https://gitlab.mega-pol.ru/Documentation/Guides/-/wikis/Страница-с-руководством-по-установке-и-настройке-Jenkins)