Skip to content

Remove hashes in front of commands#10219

Merged
frenck merged 1 commit into
home-assistant:currentfrom
Derkades:patch-1
Aug 25, 2019
Merged

Remove hashes in front of commands#10219
frenck merged 1 commit into
home-assistant:currentfrom
Derkades:patch-1

Conversation

@Derkades
Copy link
Copy Markdown
Contributor

On the website they look like commented lines:
image

On the website they look like commented lines
@probot-home-assistant probot-home-assistant Bot added the current This PR goes into the current branch label Aug 24, 2019
@fabaff
Copy link
Copy Markdown
Member

fabaff commented Aug 25, 2019

On the website they look like commented lines:

Then the CSS needs to be adjusted. # and $ are used to distinguish between commands which should be run as root and those for users.

@Derkades
Copy link
Copy Markdown
Contributor Author

It makes sense to display them as comments for bash scripts. They are actually comments

@klaasnicolaas klaasnicolaas added enhancement ready-for-review This PR needs to be reviewed labels Aug 25, 2019
Copy link
Copy Markdown
Member

@frenck frenck left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @Derkades! 👍

@fabaff These are being removed for many reasons.

  1. Copy/paste made easy.
  2. Conflicts with Markdown rules MD014.
  3. Is requested not to in our own developer docs.
  4. Highlighting issues, as # in shell scripts are used as comments.
  5. If $ & # root/user? TBH if that is the indicator, the documentation around it is incomplete and unclear. Most of our user base will not know the difference.

@frenck frenck merged commit 1386728 into home-assistant:current Aug 25, 2019
@probot-home-assistant probot-home-assistant Bot removed the ready-for-review This PR needs to be reviewed label Aug 25, 2019
@DubhAd
Copy link
Copy Markdown
Contributor

DubhAd commented Aug 25, 2019

@fabaff Looks like our own documentation standards on this were updated by Frenck last month - it's caught quite a few of us out having the standard reversed ;)

@frenck
Copy link
Copy Markdown
Member

frenck commented Aug 25, 2019

@DubhAd As explained to you in the other PR as well, this has been applied by me & @klaasnicolaas for quite some time now, and have been actively removing it from many places way longer already.

StephenWetzel pushed a commit to StephenWetzel/home-assistant.io that referenced this pull request Aug 26, 2019
On the website they look like commented lines
jjlawren pushed a commit to jjlawren/home-assistant.io that referenced this pull request Aug 26, 2019
On the website they look like commented lines
@bbrendon bbrendon mentioned this pull request Sep 23, 2019
2 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

current This PR goes into the current branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants