On Fri, Nov 19, 2021 at 5:39 PM Tommy Murphy <tommy_mur...@hotmail.com> wrote: > > Hi Antonio > > Don't some, most, or all of those commands have a help string (at least a > brief summary description) embedded in the code in which case maybe these > could/should be "harvested" from the source code into the docs rather than > having duplication?
Hi Tommy, it would be nice to have the complete command's description; with even few examples, when relevant. But today we face 170 commands not documented at all; copy/paste the short string from help is not the best, but it requires the lowest effort and could be done relatively fast. For me the help text is just a starting point, and better than nothing! While reviewing these patches we can still suggest some improvement. And once the commands land in the documentation, users can propose other changes while reading/reviewing the documentation. Let's see how it goes! > In the meantime, with the de facto approach, I might have some time to tackle > some of these, maybe starting with the RISC-V ones. Thanks! Antonio