docs(build_command): Add newline to fix table rendering #996
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Purpose
While reading the configuration page in the docs, I was reading the build_command section and noticed that the table describing the the environment variables on Windows systems was corrupted.
This PR fixes that issue so that the table is rendered correctly.
Rationale
I suspected it was likely a whitespace / newline issue, because reStructuredText depends on delineation between elements for the parser to identify those elements. When I located the source for this content I expected to find a paragraph element with the text
In addition, on windows systems these environment variables are passed:
followed by the markup for a table, but no newline separating the two elements.How did you test?
I cloned the repo and built the docs to verify that the issue existed in my local version of the docs. Then I found source file and added a newline between the text and table markup. Finally, I re-built the documentation and verified that the table rendered correctly.
How to Verify
HEAD
onorigin/main
of the PSR repo).configuration
page and then down to thebuild_command
section.Verify that the table is now rendered correctly.