jolly-good-toolbelt / sphinx_gherkindoc

A tool to convert Gherkin into Sphinx documentation
https://jolly-good-toolbelt.github.io/sphinx_gherkindoc/
11 stars 10 forks source link

Get rid of step indentation formatting #20

Closed rbcasperson closed 4 years ago

rbcasperson commented 4 years ago

Now that we can format step keywords how we want with a CSS file, the step indentation is less desirable, and having thought about it again, I think it isn't a good idea anyway.

No where in Gherkin do And steps get indented separately, and also the indentation can give the idea that they are lesser steps, when really they are just there so make it read more easily.

We can add this back in and have it configurable, but my feeling is that we should drop it altogether.

This was added with https://github.com/jolly-good-toolbelt/sphinx_gherkindoc/pull/3, and there was much discussion. But since then, minds have changed. We always reserve the right to get smarter, so today I'm exercising that right :)

Before:

Screen Shot 2020-01-31 at 10 46 58 AM

After:

Screen Shot 2020-01-31 at 10 55 20 AM

Note that I could highlight the step keywords, but didn't in this case