Ссылка на указанную c ветку, тег или коммит, или на конкретный c файл внутри него, или на указанную c строку в этом файле? - PullRequest
1 голос
/ 01 мая 2020

Я создаю учебное пособие, в котором я хочу представить некоторые среды тестирования, такие как Mockito, WireMock и EasyMock. Я хочу объяснить это шаг за шагом. Кроме того, я хочу привести примеры, где читатель учебника может попытаться воссоздать их. Поэтому я хочу дать им возможность заглянуть в мой исходный код и использовать его, когда они не могут воссоздать тест. И затем они могут использовать текущую версию для продолжения, а затем снова, когда они не могут создать следующий тест, я хочу дать им возможность использовать мою новую версию с новым тестом.

Мой Идея состоит в том, чтобы использовать различные коммиты и связать их с руководством. Как я могу это сделать или есть ли лучший подход для достижения того, что я только что объяснил?

1 Ответ

0 голосов
/ 01 мая 2020

Easy Peasy!

Основной подход c заключается в следующем: найдите именно то, что вам нужно на GitHub, а затем предоставьте URL. URL-адреса GitHub являются стабильными постоянными ссылками, даже если вы переходите к старой ревизии или другой ветке.

  1. Откройте репо в Github.
  2. Перейдите к ветви, тегу или коммиту, который вы хотите.
    • Для ветви / тега в левом верхнем углу списка файлов есть раскрывающийся список.
    • Для конкретного c коммита:
      1. Нажмите Commits в верхняя часть списка файлов. Это приведет вас к странице, показывающей все различия. (Вы можете поделиться этим URL, если хотите. В противном случае перейдите к следующему шагу.)
      2. Нажмите Browse files в верхнем правом углу.
  3. Теперь вы смотрите на представление хранилища точно так же, как то, с которого вы начали, за исключением того, что это представление имеет специфическую c ветку, тег или коммит. Это как машина времени GitHub.
    • Если вы хотите создать ссылку на весь репозиторий в этой ветви / теге / коммите, скопируйте URL прямо сейчас.
    • Если вы хотите создать ссылку на определенный файл в этой ветви / теге / commit, перейдите к файлу в списке, затем скопируйте этот URL.
    • Если вы хотите создать ссылку на определенную строку в файле, щелкните номер строки, затем нажмите на Кнопка ..., которая появляется рядом с ней, а затем нажмите Copy permalink
    • Если вы хотите создать ссылку на диапазон строк в файле, удерживайте нажатой клавишу shift и кликните на другом конце Диапазон линий. Линии будут выделены. Нажмите на кнопку ..., которая появляется рядом с ней, а затем нажмите Copy permalink

Все, что сказано, если вы не проходите их через множество итераций код, я не уверен, что дать им ссылки на версии в истории git - это путь к go. Допустим, они хотят клонировать ваш репо. Тогда им нужно будет git checkout example-2-version-3 или что-то в этом роде.

Более типичный подход - поместить разные версии в иерархию каталогов, что упрощает просмотр, будь то на GitHub или локальном клоне вашего репозитория. .

...