Я работаю над диссертацией с отличием и разработал библиотеку Fortran, которую я хотел бы процитировать в ней.
Кое-где предлагают цитировать документацию проекта, но это то, что я планирую сделать в будущем и еще не сделано. Единственная документация, которая у меня есть сейчас, это файл README и сам код.
Что было бы приемлемым способом направить читателя к моей работе на Github?
(бонус) Есть ли способ BibTeX сделать это?
GitHub добавил встроенную поддержку цитирования ( https://twitter.com/natfriedman/status/1420122675813441540 ). Просто добавьте CITATION.cff
файл ( https://citation-file-format.github.io/ ) в свой репозиторий, и виджет цитирования будет добавлен на боковую панель:
Я бы пошел с:
PWD Charles, Название проекта, (2013 г.), репозиторий GitHub, https://github.com/charlespwd/project-title
Или немного по-другому, в зависимости от вашего стиля цитирования. Важно только указать: автора, название (если это предусмотрено стилем), год и ссылку.
Конечно, если у вас есть публикация, связанная с этим фрагментом кода (даже если только по факту, что это ваша первая публикация, основанная на этом коде), не забудьте процитировать и ее! (В нынешней академической системе это все, что имеет значение.)
И соответствующая запись BibTeX:
@misc{Charles2013,
author = {Charles, P.W.D.},
title = {Project Title},
year = {2013},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/charlespwd/project-title}},
commit = {4f57d6a0e4c030202a07a60bc1bb1ed1544bf679}
}
Осторожно, это импровизация (особенно запись BibTeX), а не стандарты.
Даже для более устоявшихся и цитируемых вещей не установлены стандарты, см., например:
Смотрите также:
РЕДАКТИРОВАТЬ:
См. также , как присвоить DOI конкретной фиксации в вашем репозитории .
url={https://github.com/charlespwd/project-title}
Меня попросили предоставить мой комментарий в качестве ответа, так что вот он. Это еще один способ цитирования программного обеспечения. Однако это требует определенных усилий от авторов программного обеспечения.
Я разработал веб-инструмент с открытым исходным кодом для моделирования и сбора данных, следуя определенной теории/методологии разработки программного обеспечения. Вот как бы вы это процитировали:
Грациотин, Д. и Абрахамссон, П. 2013. Веб-инструмент моделирования для теории разработки программного обеспечения SEMAT Essence. Journal of Open Research Software 1(1):e4, DOI: http://dx.doi.org/10.5334/jors.ad
Это возможно, потому что я решил опубликовать статью о программном обеспечении в Journal of Open Research Software . Это журнал с полностью открытым доступом. Этот журнал принимает только статьи о программном обеспечении с открытым исходным кодом для исследований .
Документ по программному обеспечению — это особый вид документа, в котором описывается программное обеспечение, например, что это такое, реализация и архитектура, его доступность и потенциал повторного использования. Редакционный процесс работает так же, как и в любом другом исследовательском центре, а статьи рецензируются.
Плата за обработку статьи составляет 25 фунтов стерлингов. Однако от них можно полностью отказаться, если вы не можете себе их позволить.
Что хорошо в этом подходе, так это то, что у исследователей есть дополнительная мотивация открыть свое программное обеспечение для исследования: они получают за это публикацию плюс цитирование. Кроме того, написать статью о программном обеспечении намного проще, чем написать статью о методологии .
Я написал рецензию на журнал в своем блоге . TL;ДР; Отличный опыт, дерзайте.
Теперь их можно как-то цитировать, предоставляя ссылки DOI. Это было в их новостях от 14 мая: https://github.com/blog/1840-improving-github-for-science .
GitHub теперь предлагает цитирование как услугу, по крайней мере, с Zenodo. В этом руководстве рассказывается, как подключить свои учетные записи и получить DOI с вашей работой:
https://guides.github.com/activities/citable-code/
Основной вопрос, по-видимому, заключается в том, как получить цитируемое программное обеспечение.
Для этого существует традиционный метод.
Вы пишете методологию, описывающую программное обеспечение, как оно было создано и что оно делает. Вы можете предоставить исходный код в качестве дополнительной информации.
И затем вы цитируете эту статью в будущих статьях, где вы применяете программное обеспечение.
Чаще всего я видел сноску с URL-адресом, который вы хотите предоставить, в данном случае URL-адрес вашего репозитория GitHub. Это еще лучше укажет людям, потому что будет на той же странице, и, конечно, это не будет учитываться в библиографической статистике и вашем h-индексе, но в любом случае это не будет учитываться, по крайней мере, пока.
Figshare предоставляет способ импортировать выпуск GitHub и присваивает ему doi. Я еще не пробовал это, но, похоже, это хороший средний путь между документом по программному обеспечению и цитированием только репозитория.
Лететь в
Петр Мигдаль
чарльспвд
Лететь в
Петр Мигдаль
Петр Мигдаль
Дон Джо