Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix minor godoc typos in any package #569

Merged
merged 1 commit into from
Mar 28, 2018
Merged

Fix minor godoc typos in any package #569

merged 1 commit into from
Mar 28, 2018

Conversation

johnmccabe
Copy link
Contributor

An extra space was causing Examples 3 and 4 to render in Example 2's code block. This commit fixes those minor typos.

Also removing the ==== denoting the JSON section will allow godoc to render a heading here.

Before - click to expand

screen shot 2018-03-28 at 16 44 55

After - click to expand

screen shot 2018-03-28 at 16 45 12

An extra space was causing Examples 3 and 4 to render in Example 2's
code block. This commit fixes those minor typos.

Also removing the `====` denoting the JSON section will allow godoc to
render a heading here.

Signed-off-by: John McCabe <john@johnmccabe.net>
@neild neild merged commit e09c5db into golang:master Mar 28, 2018
@neild
Copy link
Contributor

neild commented Mar 28, 2018

Thanks!

neild pushed a commit to neild/protobuf that referenced this pull request Mar 28, 2018
An extra space was causing Examples 3 and 4 to render in Example 2's
code block. This commit fixes those minor typos.

Also removing the `====` denoting the JSON section will allow godoc to
render a heading here.

Signed-off-by: John McCabe <john@johnmccabe.net>
@dsnet
Copy link
Member

dsnet commented Mar 28, 2018

Thank you for the doc fix. However, given the issues we're discovering in #569, perhaps we should roll this back? Poorly generated godoc is affecting the godoc for nearly all of the well-known types (not just Any).

@neild
Copy link
Contributor

neild commented Mar 28, 2018

I'm okay with either rolling back or leaving it until it gets overwritten when we merge dev to master. Up to you.

@johnmccabe
Copy link
Contributor Author

@dsnet @neild what issues have you observed?

@dsnet
Copy link
Member

dsnet commented Mar 28, 2018

Apologies, I meant to reference #570.

@johnmccabe
Copy link
Contributor Author

Had just seen that, if theres anything you need me to do my side just shout.

chyroc pushed a commit to chyroc/protobuf that referenced this pull request May 1, 2018
An extra space was causing Examples 3 and 4 to render in Example 2's
code block. This commit fixes those minor typos.

Also removing the `====` denoting the JSON section will allow godoc to
render a heading here.

Signed-off-by: John McCabe <john@johnmccabe.net>
@golang golang locked and limited conversation to collaborators Jun 26, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants