Remove indentation causing RST errors

[melissamahoney-mongodb]

We generate our docs in RST from Cobra. I removed the indentations causing an error in the generated RST. This also makes the long descriptions consistent with the other completion commands.

[CLAassistant]

All committers have signed the CLA.

[umarcor]

Maybe keep the indentation and add .. code:: sh before? See https://docutils.sourceforge.io/docs/ref/rst/directives.html#code

[marckhouzam]

Would this be interpreted correctly for the help message @umarcor ?

[umarcor]

To be honest, I am genuinely confused. To my understanding, the help message is printed to screen/terminal, so unrelated to RST. My previous reply was considering that line 619 is going to end being part of a restructuredtext file. However, I now see why you are asking, since this is indeed the "Long" field of a command. Is the same text source used for both printing the help in screen and for generating the rst docs?

[marckhouzam]

It's definitely used for the help message and I'm learning with this PR that it is also used for RST. So the original idea of removing the indentation is probably the best way forward. What do you think?

[umarcor]

I think it is technically not correct to remove the indentation, because the resulting RST is not semantically valid. However, given the constraints, I believe it's fair enough. It allows removing the error found by @melissamahoney-mongodb and we don't need to learn the details of doc generation right now. I'll mark this dialogue as resolved, and we'll deal with docgen some other day 😉.

EDIT

It seems I cannot mark it as resolved myself. @melissamahoney-mongodb, do you mind marking, please?

[github-actions]

This PR is being marked as stale due to a long period of inactivity

[marckhouzam]

I think this PR is giving problems:

1. it removes indentation while fix: improve completions help formatting #1444 adds indentation. When both are joined in 🍁 Fall 2021 - release candidate #1525 we are not consistent with the indentation between completion bash -h and the other shells (e.g., completion zsh -h)
2. the indentation allows nice code-block formatting in markdown, so I feel it is better to have it than not

@melissamahoney-mongodb can you specify how you get an error when generating RST doc? I haven't been able to reproduce it.

@umarcor what do you think? I personally would pull this out of the release candidate until we can clarify the situation.

[umarcor]

@marckhouzam I removed this from #1496 and I pulled it out of #1525.

It seems that supporting multiple output formats might require explicitly handling multiple text sources...