Remove cli generated reference

[gianarb]

We are deeply re-shaping the CLI right now

tinkerbell/tink#405
tinkerbell/tink#425
tinkerbell/tink#426

And the fact that we do not have a good way to automatically keep this section
up to date with a particular version of tinkebell/tink makes the maintenance not
that fun

[gianarb]

any thought about it @DailyAlice ? Should we remove it or not? Personally I never look at this kind of documentation, I download the CLI and I use --help :D

[thebsdbox]

You mean remove things like https://docs.tinkerbell.org/cli-reference/hardware/ ?

I agree that it is going to be hard as documentation to maintain... and I don't know what we can do to make that easier. It seems like good documentation that it would be a shame to lose though :-(

[gianarb]

Well, you don't use it, you have the same, but up to date via tink --help :) we can mention that in the tink-cli document

[mmlb]

👍 to have equivalent or better docs in tink --help (I'd love a man page)

[gianarb]

I will open a PR to remove those files. About man cobra can generate it and o think we exposed that capability already.

…

On Tue, 2 Feb 2021, 19:04 Manuel Mendez, ***@***.***> wrote: 👍 to have equivalent or better docs in tink --help (I'd love a man page) — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#70 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAMOAO2COU5LAZJBCZG2UMLS5A5CTANCNFSM4W7A67SQ> .

[DailyAlice]

I'm good with having better tink --help in favor of a CLI Reference in docs. And, if after the changes, we see a need for something closer to these docs, we can always make new ones.

[DailyAlice]

I started to work on removal on a branch - https://github.com/DailyAlice/tinkerbell-docs/tree/cli-ref-removal

Think I might just add a line about using tink --help in the Tink CLI doc, and maybe also expand on getting the Tink CLI up and running with tink-server.