Stop Collecting GitHub Repos. Use One Like This.

Описание и применение

Маленький, повторяемый рабочий процесс, позволяющий изучить репозиторий, изменить одно поведение и проверить результат, превращая сохранённый код в понятный и проверяемый artefact.

Задача

Saved repositories become unexamined promises; developers lack a concrete finish line to understand and modify code.

Результат

The workflow enables a developer to understand a codebase, make a small, well-defined change, and verify it with tests, turning a saved repo into a learnable artifact.

Рабочий процесс

• Choose a repository and a single observable behavior.
• Identify an entry point (route, command, component, etc.).
• Predict the expected outcome before running the example.
• Run the example and compare actual behavior to the prediction.
• Locate the code path that implements the behavior.
• Make a focused change that limits the homepage to three posts.
• Add a test that verifies the new behavior and ensures data remains intact.
• Document the process in a note with behavior, path, prediction, change, evidence, and limits.

Доказательства

Choose a question with an observable answer instead: where does this page get its data, what determines the output order, or how does an invalid input reach an error message?

Источник

In a local branch, change the example so the homepage shows at most three newest posts.

Источник

Read the existing checks before adding your own. In this example, tests/test_blog.py includes a homepage test that looks for expected content.

Источник