Вітаємо! В цьому репозиторії міститься все необхідне для роботи над сайтом і документацією Kubernetes. Ми щасливі, що ви хочете зробити свій внесок!
Ви можете створити копію цього репозиторія у своєму акаунті на GitHub, натиснувши на кнопку Fork, що розташована справа зверху. Ця копія називатиметься fork (відгалуження). Зробіть будь-які необхідні зміни у своєму відгалуженні. Коли ви будете готові надіслати їх нам, перейдіть до свого відгалуження і створіть новий pull request, щоб сповістити нас.
Після того, як ви створили pull request, рецензент Kubernetes зобов’язується надати вам по ньому чіткий і конструктивний коментар. Ваш обов’язок як творця pull request - відкоригувати його відповідно до зауважень рецензента Kubernetes. Також, зауважте: може статися так, що ви отримаєте коментарі від декількох рецензентів Kubernetes або від іншого рецензента, ніж той, якого вам було призначено від початку. Крім того, за потреби один із ваших рецензентів може запросити технічну перевірку від одного з технічних рецензентів Kubernetes. Рецензенти намагатимуться відреагувати вчасно, проте час відповіді може відрізнятися в залежності від обставин.
Більше інформації про внесок у документацію Kubernetes ви знайдете у наступних джерелах:
- Внесок: з чого почати
- Візуалізація запропонованих змін до документації
- Використання шаблонів сторінок
- Керівництво зі стилю оформлення документації
- Переклад документації Kubernetes іншими мовами
| Англійська | Французька |
| Корейська | Німецька |
| Португальська | Хінді |
| Іспанська | Індонезійська |
| Китайська | Японська |
| В'єтнамська | Російська |
| Італійська | Польська |
Для локального запуску сайту Kubernetes рекомендовано запустити спеціальний Docker-образ, що містить генератор статичних сайтів Hugo.
Якщо ви працюєте під Windows, вам знадобиться ще декілька інструментів, які можна встановити за допомогою Chocolatey.
choco install make
Якщо ви вважаєте кращим запустити сайт локально без використання Docker, дивіться пункт нижче Запуск сайту локально за допомогою Hugo.
Якщо у вас вже запущений Docker, зберіть локальний Docker-образ kubernetes-hugo:
make docker-imageПісля того, як образ зібрано, ви можете запустити сайт локально:
make docker-serveВідкрийте у своєму браузері http://localhost:1313, щоб побачити сайт. По мірі того, як ви змінюєте вихідний код, Hugo актуалізує сайт відповідно до внесених змін і оновлює сторінку у браузері.
Для інструкцій по установці Hugo дивіться офіційну документацію. Обов’язково встановіть розширену версію Hugo, яка позначена змінною оточення HUGO_VERSION у файлі netlify.toml.
Після установки Hugo, запустіть сайт локально командою:
make serveКоманда запустить локальний Hugo-сервер на порту 1313. Відкрийте у своєму браузері http://localhost:1313, щоб побачити сайт. По мірі того, як ви змінюєте вихідний код, Hugo актуалізує сайт відповідно до внесених змін і оновлює сторінку у браузері.
Дізнайтеся, як долучитися до спільноти Kubernetes на сторінці спільноти.
Для зв’язку із супроводжуючими проекту скористайтеся:
Участь у спільноті Kubernetes визначається правилами Кодексу поведінки спільноти Kubernetes.
Долучення до спільноти - запорука успішного розвитку Kubernetes. Ми цінуємо ваш внесок у наш сайт і документацію!