documentation request for colmenaHive

[nazarewk]

the issue

It's not possible to discover existence of <flake>#colmenaHive mechanism without prior (somebody else's) knowledge. It would be great to have it documented in flake interface or any other self-discoverable place.

background

I started out by learning to use divnix/std, then colmena itself to update a GCE instance, which I did successfully by assembling pieces together into <flake>#colmena output.

Then I learned of divnic/hive and started migrating to it's colmenaConfigurations block type. I tried to use it as colmena = hive.collect self "colmenaConfigurations";, but was told on it's Element chat to use colmenaHive = hive.collect self "colmenaConfigurations"; instead.

I was told it's standard colmena interface, it seems so, but there is hardly any information on it in code or docs:

• a GitHub search on the repo for the term yields only:
  • 4 code occurrences: 3 comments/error strings and a test
  • 2 commits
• a docs search https://colmena.cli.rs/unstable/?search=colmenaHive yields no results at all

After knowing of it's existence I was able to determine <flake>#colmenaHive is some kind of evaluated representation of <flake>#colmena which can be used directly, but I would never be able to learn of existence of such feature on my own.