Skip to content

[gh config][website manual] Escape pipe symbols in long description#10688

Closed
iamazeem wants to merge 1 commit intocli:trunkfrom
iamazeem:10678-contain-pipe-escaping
Closed

[gh config][website manual] Escape pipe symbols in long description#10688
iamazeem wants to merge 1 commit intocli:trunkfrom
iamazeem:10678-contain-pipe-escaping

Conversation

@iamazeem
Copy link
Copy Markdown
Contributor

Fixes #10678.

This PR is an improvement on #10371.
This escapes the pipe symbols for the gh config command only.
The existing solution escapes pipe symbols for all the commands which has side effects in addition to what has been reported in #10678.

This is an issue with kramdown and others have been facing it too.
Here in this SO thread, replacing the kramdown parser has been suggested in this answer.
Not sure how much control jekyll provides and whether it's doable or not.
It would be good to look into to avoid such workarounds in the future given that some other parser works fine.

@iamazeem iamazeem requested a review from a team as a code owner March 28, 2025 07:28
@iamazeem iamazeem requested a review from BagToad March 28, 2025 07:28
@cliAutomation cliAutomation added the external pull request originating outside of the CLI core team label Mar 28, 2025
@iamazeem iamazeem changed the title [gh config][manual] Escape pipe symbols in long description [gh config][website manual] Escape pipe symbols in long description Mar 28, 2025
@babakks babakks self-requested a review May 16, 2025 09:55
@babakks
Copy link
Copy Markdown
Member

babakks commented May 16, 2025

Thanks for the PR, @iamazeem! 🙏

I put some time to investigate this, and as you said, the last fix has had side effects. Here are the instances I have found:

Among these, I believe the gh help reference case is the most annoying one, because it's meant to be a precise reference document, and also SEO-friendly.

So, I agree with reverting the last change, but I don't think it's a good idea to single out gh config. What if we create/update a command in the future and introduce the same problem? We wouldn't know until someone catches it.

For now, I'll close this PR since I think we a need a little discussion with the team on the issue. I'm going to recap what's going on and suggest a solution, and then wait for folks to comment their thoughts.

@babakks babakks closed this May 16, 2025
@iamazeem iamazeem deleted the 10678-contain-pipe-escaping branch May 17, 2025 07:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external pull request originating outside of the CLI core team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

PowerShell completion code has pipe | as &#124 on website

3 participants