Є два офіційні блоги Kubernetes, а CNCF має власний блог, де ви також можете писати про Kubernetes. У головному блозі Kubernetes ми (проєкт Kubernetes) радо публікуємо статті з різними поглядами та особливими акцентами, що мають стосунок до Kubernetes.
Деякі статті зʼявляються в обох блогах: є основна версія статті та дзеркальна стаття в іншому блозі.
На цій сторінці описано критерії віддзеркалення, його причини, а також що потрібно зробити, щоб стаття була опублікована в обох блогах.
Переконайтеся, що ви ознайомилися зі вступними розділами сторінки Дописи у блог Kubernetes, не лише щоб дізнатися про два офіційні блоги та відмінності між ними, а й щоб отримати загальне уявлення про процес.
Віддзеркалення майже завжди відбувається з блогу учасників до головного блогу. Проєкт робить це для статей, які стосуються спільноти учасників або її частини, але також цікаві ширшому колу читачів головного блогу Kubernetes.
Як автор (або рецензент), зважте на цільову аудиторію і на те, чи підходить допис для головного блогу. Наприклад, якщо цільова аудиторія — лише учасники Kubernetes, доречнішим може бути блог учасників; якщо допис стосується відкритого коду загалом, він може краще підійти для іншого сайту поза проєктом Kubernetes.
Це міркування про цільову аудиторію однаково стосується як оригінальних, так і дзеркальних статей.
Проєкт Kubernetes готовий віддзеркалити будь-яку статтю блогу, опубліковану на https://kubernetes.dev/blog/ (блог учасників), якщо виконано всі такі критерії:
Віддзеркалена стаття має ту саму дату публікації, що й оригінал (вона також має мати той самий час публікації, але для особливих випадків можна встановити позначку часу до 12 годин пізніше)
Для PR, які додають дзеркальну статтю до головного блогу після того, як оригінальну статтю злито в блог учасників, переконайтеся, що виконано всі такі критерії:
Це повʼязано з тим, що проєкт Kubernetes не бажає додавати статті до стрічок користувачів, таких як RSS, окрім як у самому кінці стрічки.
Оригінальна стаття не порушує жодних наполегливо рекомендованих настанов рецензування чи норм спільноти
У віддзеркаленій статті буде правильно вказано canonicalUrl у її front matter
Аудиторія оригінальної статті вважатиме її доречною
Вміст статті не виходить за межі тематики цільового блогу, де зʼявиться дзеркальна стаття
Віддзеркалення з головного блогу в блог учасників трапляється рідко, але цілком можливе.
Ви створюєте PR до іншого Git-репозиторію (зазвичай https://github.com/kubernetes/website), який додає статтю. Це потрібно зробити до злиття статей.
Як автор статті, ви маєте встановити для віддзеркаленої статті канонічну URL-адресу — URL-адресу оригінальної статті (можна скористатися попереднім переглядом, щоб передбачити URL-адресу і заповнити її до фактичної публікації). Для цього використовуйте поле canonicalUrl у front matter.