Enhanced Support for Citations on GitHub

https://github.blog/2021-08-19-enhanced-support-citations-github/

by chenzhekl • 5 years ago

80 18 5 years ago

tasogare• 5 years ago

YAML

Can't we let this format die? It's both hard for human to format correctly, and for library creator to make a compliant parser.

encryptluks22• 5 years ago

It's both hard for human to format correctly, and for library creator to make a compliant parser.

It is actually very easy to format correctly, unless you don't understand the format. While it may challenging to make a compliant parser, many exists for multiple languages.

JSON isn't a viable replacement.. TOML doesn't support root level lists and has its own set of challenges and is a lot more ugly and difficult to understand for complex nested structures.

If you want to kill YAML then replace it with HCL.

koolba• 5 years ago

What’s HCL?

XorNot• 5 years ago

TOML is atrocious. In trying to look ini-like its table and nested structures become completely inscrutable.

I only ever deal with it by writing what I need in YAML and running a converter.

diob• 5 years ago

I have the same problems as you. For some reason I can't work in that type of format (similarly with Python).

No beef against those that love it, my brain just can't handle it.

prepend• 5 years ago

Meh. It’s ok. I’ve used it in many projects and languages while never caring about and being able to find an OSS parser in all languages.

BossingAround• 5 years ago

Most people I know have had an issue where they misunderstood what an object in a YAML file is (and therefore did not apply a configuration) or something similar.

Bonus points for mis-editing a kube object (kubectl edit) that you save correctly only to realize that mis-formatted YAML can get thrown away without reporting an error back (looking at you Istio).

And yet people choose it again and again for new projects. Someone must love it given the popularity...

aorth• 5 years ago

Ah great! It indeed seems to be enhanced now, as opposed to a few weeks ago when GitHub CEO Nat Friedman announced initial support https://twitter.com/natfriedman/status/1420122675813441540. I had used the CFF initializer website https://citation-file-format.github.io/cff-initializer-javas... to create my CFF file, but GitHub couldn't parse it. Now it's working!

ivalm• 5 years ago

Why not use bibtex directly?

nextaccountic• 5 years ago

This generates the bibtex code for you.

otherme123• 5 years ago

Doesn't answer the question: why? BibTex, and others, has been around forever. A lot of software already interconvert Ris, Bibtex, Xml...

At least tell me what is your new format trying to solve, like Png solved Gif flaws. My bibliography DB is in bibtex, my citable repos include a bibtex, and I'm not switching to this thing.

What would I do? Create a doc explaining how our service now parses a file called CITATION that could be a Ris or a Bibtex, with the following fields: A,B,C... and that's it.

westurner• 5 years ago

CITATION.cff files are plain text files with human- and machine-readable citation information. When we detect a CITATION.cff file in a repository, we use this information to create convenient APA or BibTeX style citation links that can be referenced by others.

https://schema.org/ScholarlyArticle RDFa and JSON-LD can be parsed with a standard Linked Data parser. Looks like YAML-LD requires quoting e.g. "@context": and "@id":

From https://docs.github.com/en/github/creating-cloning-and-archi... ; in your repo's /CITATION.cff:

  cff-version: 1.2.0
  message: "If you use this software, please cite it as below."
  authors:
  - family-names: "Lisa"
    given-names: "Mona"
    orcid: "https://orcid.org/0000-0000-0000-0000"
  - family-names: "Bot"
    given-names: "Hew"
    orcid: "https://orcid.org/0000-0000-0000-0000"
  title: "My Research Software"
  version: 2.0.4
  doi: 10.5281/zenodo.1234
  date-released: 2017-12-18
  url: "https://github.com/github/linguist"

https://citation-file-format.github.io/

danra• 5 years ago

How about extending this feature to automatically add in the required licenses for the sources of Copilot-generated code?

thenoblesunfish• 5 years ago

This seems like an attempt to make GitHub stickier, and should be avoided. Just give people BibTeX to copy and paste, and don’t let Microsoft railroad you into using their formats, yet again.

Enhanced Support for Citations on GitHub

Related Stories