Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Семейный значок: подъём на v1.11.0 каталога, факты 1.5 и пара с глоссарием

Open
  • Is something wrong?
#1,626 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
8/100
Issue type
Refactor
Clarity
Needs clarification
Activity status
Active
Tech stack
github-actions, python
Domain
ci-cd, tooling

Research direction

Start from .github/badges/contracts.json and .github/badges/facts.json in this repo, then the catalog's export/README.md section «Манифест семьи» and scripts/family.py (изъян_формы) for the manifest shape. Done means the upgraded pins, a valid manifest with the takes entry and an EPM skip or a gives entry, and a family_check.py run that comes back green. Several steps need the owner's decisions and a maintainer's answer before any edit.

Written by the indexing model from the issue text.

Description

Зачем

Каталог выпустил v1.11.0 — семейный значок (ArtVsMark/Engineering-Incidents-Playbook, тег v1.11.0, коммит 5d10def7c6c8). Каждый проект семьи показывает одним значком, сходится ли он с контрактами семьи:

  • слева — что он отдаёт (gives) и что берёт: у семьи (family), парно (pairs), внешние (ext);
  • справа — у кого: EIP (каталог), EPM (механизмы), AVM (витрина).

Цвета (решение владельца 09.10):

  • любое отставание по семье и парам — красный, минор тоже: выпуск минора у издателя и есть смена контракта;
  • нет данных — серый, и в зелёный он не засчитывается;
  • связи с издателем нет — красный —, пока отказ не объявлен с причиной в skips манифеста.

Значок каталога уже опубликован: .github/badges/family.svg на его ветке badges.

Что нужно от проекта

Потребитель семьи и парный потребитель глоссария.

  1. Подняться на свежие выпуски:
    • корневое действие каталога прибито к 4b81f08 — это v1.6.0 → v1.11.0;
    • python-badge на 29657e0 (v1.10.0) → v1.11.0.
  2. Факты .github/badges/facts.json: 1.2 → 1.5 (договор витрины, тег facts-v1.5.0). Это самое большое отставание в семье. Шаг проверки витрины — из её договора, с прибитыми sha256.
  3. Манифест. Наружу семье вы контрактов не отдаёте, поэтому gives пуст. Но манифест нужен ради пары и отказов:
    • takes — {"from": "ArtVsMark/Glossary-Python", "contract": "glossary-form", "where": "src/stepik_grader/glossary/data/_source.json", "field": "form"}. Сейчас там выпуск глоссария v1.4.0, форма 6.1. Имя контракта согласуем с глоссарием: ему отправлено то же предложение.
    • skips — {"EPM": "<причина>"}, если шаги механизмов грейдеру не нужны. Без отказа EPM на значке будет красным —.
  4. Ответ каталогу: schema 1.9, answers_to 1.7 — сходится.
  5. Аудит правил. Ответ полный: 217 правил, действует 212, гейтом 95, конвейером 43, документом 74. Документом держится больше всех в семье. Стоит перечитать эти 74 надвое по правилу 182: у многих машинная половина уже построена у соседей (export/where.json, раздел «решено у соседа»).
  6. Данные по гипотезам (ArtVsMark/Engineering-Incidents-Playbook#798) приняты: занесены в оба кандидата разделом «Данные потребителей». Канал для таких данных (kind: evidence) — на решении владельца.

Общее для всей семьи

  • Манифест .github/badges/contracts.json на своей ветке badges — контракт family 1.1, форма в каталоге: export/README.md → «Манифест семьи», сборщик и проверка формы — scripts/family.py (изъян_формы). Поля:
    • schema, project;
    • release — тег и коммит последнего выпуска;
    • gives — что отдаёте: контракт → мажор.минор;
    • takes — парные связи, которых не найти автоматически;
    • skips — отказ от связи с издателем, с причиной.
  • Выпуски. Выпуск минора — это смена того, что вы отдаёте. Выпускать при такой смене и обновлять release в манифесте: по нему соседи узнают, что пора подниматься.
  • Сверка. Действие family-badge@vX каталог отдаст следующим шагом. До него сверка — scripts/family_check.py каталога: он находит в дереве, на чём стоит проект, и сравнивает со сводкой export/family.json.
  • Прибивать к выпуску. Прибивать к тегу или SHA выпуска, а не к main: живая ветка сменила бы требование молча.

Сводка семьи сейчас: манифест опубликован только у каталога, у остальных absent. Поэтому у всех, кроме EIP, блок издателей серый. Ваш манифест его окрасит.

Dominant language
Python
Stars
3
Forks
6
Avg merge
2h 41m
Merged PRs (30d)
48

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ArtVsMark/Stepik-Python-Grader

All issues in ArtVsMark/Stepik-Python-Grader

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.