с потоком дополнений во время Хактоберфеста я вижу, что добавлены некоторые сайты / издатели / платформы, где ссылки представлены непоследовательно.
Один из примеров - книги Goalkicker.
Большинство наших списков голкистов выглядят так:
* [Spring Framework Notes for Professionals](https://books.goalkicker.com/SpringFrameworkBook) - Compiled from StackOverflow documentation
Это дает читателям представление о том, чего ожидать, и обеспечивает правильную атрибуцию. Но не все наши голкинг-ссылки имеют одинаковый формат.
Точно так же ссылки на викиучебники были непоследовательными - уже есть PR, работающий над этим. # 4230
Список наших курсов потребовал значительных затрат, а атрибуция платформы была непоследовательной. Должен быть:
`* название, предоставленное ресурсом - Инструктор / Создатель (платформа)
Приветствуются PR для улучшения согласованности.
@eshellman Я также заметил это несоответствие, необходимо ли упоминание платформы как "YouTube" или это подразумевается, если не упоминается? Подобно некоторым ссылкам, к которым добавлен «HTML», но можно предположить, что это будет еще определенный HTML (например, PDF, EPUB и т. Д.).
@SethiPandi, что ты думаешь?
Вы могли заметить, насколько длинные все мои ответы, но я всегда был поклонником многословия и неоднозначности.
Я считаю, что всегда приятно быть откровенным, даже в том, что может сделать разумный пользователь, тем более что нет гарантии, что все пользователи будут разумными.
Единственное, что можно вывести, на мой взгляд, - это HTML, но даже в этом случае я считаю его идеальным, хотя и не обязательно обязательным для его указания. Однако я не уверен, где YouTube можно считать выводимым.
_Следующее представляет собой только мой личный опыт, а не обычного пользователя. _
Я говорю это как человек, который лично ожидал, что все книги будут в формате PDF, пока я не понял, что большинство из них на самом деле вовсе не PDF. (Я предпочитаю читать офлайн в KOReader .)
Конечно, я знаю это _now_, но не как человек, который был новичком в репозитории и не был знаком с соглашениями.
Мы можем исключить "YouTube" и "Github" из списков. Для курсов название платформы более полезно, потому что платформы предоставляют более разнообразный опыт и могут иметь требования к регистрации.
«HTML» следует указывать только в том случае, если это единственный доступный формат - часто наша ссылка ведет на веб-страницу, которая предлагает ссылки на контент различных типов.
@eshellman, хорошо, звучит хорошо
Нам нужно составить заметки о согласованности для конкретного поставщика. Так...
Please add the "Compiled from StackOverflow documentation" attribution we use for goalkicker books
For youtube, we prefer "playlist" links and the name of the producer/creators
из PR:
MIT OpenCourseWare № 5087
Викиучебник № 4230
udacity # 3880
Leanpub