News for hackers. Stuff that matters.
Re:Nvui: A NeoVim GUI written in C++ and Qt by chrismorgan on Monday August 30, 2021 @12:23AM (#28352794)
Even the screenshots don’t belong in the code repository, there’s another 2MB in this instance. I think you can still get the README to embed images from elsewhere? And if not, just link to it, “screenshots over here”.

The compromises being made in bloating repositories because GitHub presents the README as project info rather than at least allowing you to separate it are painful.

Re:Nvui: A NeoVim GUI written in C++ and Qt by Benjamin_Dobell on Monday August 30, 2021 @03:15AM (#28353392)
What happens when the URLs referenced by the README stop existing (domain expiry)? What about when the project is forked? What happens when I want to look at old documentation locally?

Why should the entire project not be subject to version control? It's a well established industry best practice.

Reproducible documentation is just as important as reproducible builds.

There's likely a strong argument to be made for Git sub-modules though i.e. putting the documentation in a sub-module.

Re:Nvui: A NeoVim GUI written in C++ and Qt by chrismorgan on Monday August 30, 2021 @03:58AM (#28353595)
This particular content isn’t documentation so much as marketing material—part of the shift GitHub has foist upon us in what a README is. But even were it documentation, that needn’t belong in the same place. This is the wisdom of rjzzleep’s suggestion of the wiki repository, an auxiliary Git repository that GitHub already creates for you.