[rfc-i] GitHub references
Heather Flanagan (RFC Series Editor)
rse at rfc-editor.org
Thu Mar 8 13:54:27 PST 2018
On 3/8/18 1:46 PM, Bob Hinden wrote:
>> On Mar 8, 2018, at 11:59 AM, Heather Flanagan (RFC Series Editor) <rse at rfc-editor.org> wrote:
>> Hello all,
>> The RFC Editor is proposing to update the reference format for
>> informative references to GitHub repositories (noting that GitHub
>> repositories are not currently accepted as normative references).
>> Specifically, we propose to standardize on the following:
>> 1) No author name(s). A repository may have many contributors, and there
>> is no way to easily determine major contributors versus all others.
>> 2) The title of the repository will be whatever is in the top left of
>> the main repository page.
>> 3) The URL will be to the main page of the repository.
>> 4) The reference will not include any particular commit hash. It will
>> include the date of the last commit at the time the RFC-to-be is edited.
>> Fan, X., Mathis, M., and D. Hamon, "Git Repository for
>> mping: An IP Level Performance Diagnostic", Sept 2013,
>> "mping", July 2016, <https://github.com/m-lab/mping>.
> Why not also include the full title, for example:
> "mping: An IP Level Performance Diagnostic", July 2016, <https://github.com/m-lab/mping>.
> I think that would make the reference more descriptive.
Where do you see the full title? Is it in a location consistent from one
repository to the next?
More information about the rfc-interest