Document gauge adapter expected output formats

[raehik]

Related to #186 . Some gauge adapters are intended to be plug-and-play, supporting common benchmark formats. PlainSecondsLog and ReBenchLog are custom and deserve some detail on the output format they expect.

[smarr]

Hi @raehik thanks for this, greatly appreciated. Just to set expectations, I fear I won't get to giving this any thought before the end of the year or early next year.

Sorry

[smarr]

@raehik thanks again, I am now looking at this and would like to add on a few other changes.

Could you "allow edits from maintainers"?
There should be a check box on the right for this. See for instance https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork

[smarr]

As a preview, with my changes, the docs would look like this: https://rebench.readthedocs.io/en/docs-reorg/extensions/

(In a just merged commit, I also changed the theme, the top navigation bar was often over the text, which wasn't great)

[raehik]

This was strangely hard to troubleshoot, but looks like I can't because the fork is on a GitHub org (thread)... let me move this PR to a personal fork instead.

[smarr]

Our you could just pull or cherry pick my change from the branch :)

[smarr]

This one here: https://github.com/smarr/ReBench/commits/docs-reorg

[raehik]

Good point! Done & removed draft tag.

[smarr]

And merged. Thanks a lot!