Free-programming-books: Последовательность объявлений (требуется помощь)

Созданный на 21 окт. 2020  ·  5Комментарии  ·  Источник: EbookFoundation/free-programming-books

с потоком дополнений во время Хактоберфеста я вижу, что добавлены некоторые сайты / издатели / платформы, где ссылки представлены непоследовательно.
Один из примеров - книги Goalkicker.
Большинство наших списков голкистов выглядят так:
* [Spring Framework Notes for Professionals](https://books.goalkicker.com/SpringFrameworkBook) - Compiled from StackOverflow documentation
Это дает читателям представление о том, чего ожидать, и обеспечивает правильную атрибуцию. Но не все наши голкинг-ссылки имеют одинаковый формат.

Точно так же ссылки на викиучебники были непоследовательными - уже есть PR, работающий над этим. # 4230

Список наших курсов потребовал значительных затрат, а атрибуция платформы была непоследовательной. Должен быть:
`* название, предоставленное ресурсом - Инструктор / Создатель (платформа)

Приветствуются PR для улучшения согласованности.

PR requested discussion help wanted

Все 5 Комментарий

@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

Была ли эта страница полезной?
0 / 5 - 0 рейтинги

Смежные вопросы

aminought picture aminought  ·  15Комментарии

hiverkiya picture hiverkiya  ·  5Комментарии

taiyoslime picture taiyoslime  ·  14Комментарии

eshellman picture eshellman  ·  5Комментарии

ghost picture ghost  ·  17Комментарии