Electric-Coin-Company / tfl-book

A Trailing Finality Layer book for a proposed Zcash protocol change.
MIT License
5 stars 2 forks source link

Add `git describe --dirty` footers to every page #126

Open nathan-at-least opened 8 months ago

nathan-at-least commented 8 months ago

What is the problem?

When viewing the rendered output at https://electric-coin-company.github.io/tfl-book/ it's not possible to tell which version is rendered.

Do you recommend a solution?

An ideal solution would be to include git describe --dirty as a footer on every page.

For a "release" revision which has a pretty tag like v0.1.0, it would display just that. If it is rendering a non-tagged commit, git describe --dirty would display a commit id suffix, like v0.1.0-a0b1c2d4.

If there are uncommitted changes, I believe it would also append * (or have some other indicator).

This would make it entirely unambiguous which git revision is rendered.