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

MINOR: [Docs] Use ' and remove trailing spaces in basic_arrow.rst #39989

Merged
merged 1 commit into from
Feb 10, 2024

Conversation

amoeba
Copy link
Member

@amoeba amoeba commented Feb 7, 2024

Rationale for this change

basic_arrow.rst had two minor issues:

  • It used (U+2019) instead of '
  • While editing, I found it wasn't whitespace normalized

What changes are included in this PR?

  • replaced with '
  • Whitespace has been normalized

Are these changes tested?

No

Are there any user-facing changes?

Just docs.

@amoeba amoeba changed the title MIONR: [Docs] Fix format issues in basic_arrow.rst MINOR: [Docs] Fix format issues in basic_arrow.rst Feb 7, 2024
@github-actions github-actions bot added the awaiting review Awaiting review label Feb 7, 2024
@kou kou changed the title MINOR: [Docs] Fix format issues in basic_arrow.rst MINOR: [Docs] Use ' and remove trailing spaces in basic_arrow.rst Feb 8, 2024
@kou
Copy link
Member

kou commented Feb 8, 2024

@github-actions crossbow submit preview-docs

@kou
Copy link
Member

kou commented Feb 8, 2024

Can we introduce linter/formatter for docs/?
We don't want to do this type checks manually...

Copy link

github-actions bot commented Feb 8, 2024

Revision: d15468a

Submitted crossbow builds: ursacomputing/crossbow @ actions-5240b8fe97

Task Status
preview-docs GitHub Actions

@amoeba
Copy link
Member Author

amoeba commented Feb 8, 2024

Not a bad idea. The original issue I found (ambiguous unicode chars) should hopefully be very rare as characters like that only get introduced when contributors use editors not meant for source code. A check in CI for the second issue (non-normalized whitespace) would be nice. I can file an issue to look into it.

@amoeba
Copy link
Member Author

amoeba commented Feb 8, 2024

I filed #39990 and will have a look.

@amoeba
Copy link
Member Author

amoeba commented Feb 8, 2024

Hey @kou, I think sphinx-lint might work here, see my comment. I didn't find anything that can catch ambiguous Unicode characters so I still think this PR should be merged. I'll work on another PR for #39990.

@kou
Copy link
Member

kou commented Feb 8, 2024

Thanks!
It seems that sphinx-lint is a good candidate. We may want to enable "trailing whitespace" at the first step and enable other checks later.

I want to ensure whether this change doesn't introduce a syntax error before I merge this. But preview-docs is broken now. I hope that #39993 solves it. Can we rebase on main and run preview-docs again after #39993 is merged?

@amoeba
Copy link
Member Author

amoeba commented Feb 8, 2024

We may want to enable "trailing whitespace" at the first step and enable other checks later.

Works for me.

Can we rebase on main and run preview-docs again after #39993 is merged?

Of course, I'll keep an eye on that.

@kou
Copy link
Member

kou commented Feb 8, 2024

I've merged #39993. Could you rebase on main?

@github-actions github-actions bot added awaiting merge Awaiting merge and removed awaiting review Awaiting review labels Feb 8, 2024
@amoeba
Copy link
Member Author

amoeba commented Feb 8, 2024

@github-actions crossbow submit preview-docs

Copy link

github-actions bot commented Feb 8, 2024

Revision: 3c7aa44

Submitted crossbow builds: ursacomputing/crossbow @ actions-d426402f0d

Task Status
preview-docs GitHub Actions

@amoeba
Copy link
Member Author

amoeba commented Feb 8, 2024

Hi @kou, I've rebased and started another docs build. I tested the output locally too and it looks fine. This should be ready for another look.

@kou
Copy link
Member

kou commented Feb 9, 2024

@github-actions crossbow submit preview-docs

Copy link

github-actions bot commented Feb 9, 2024

Revision: 571201c

Submitted crossbow builds: ursacomputing/crossbow @ actions-c509de5fda

Task Status
preview-docs GitHub Actions

@kou
Copy link
Member

kou commented Feb 10, 2024

Copy link
Member

@kou kou left a comment

Choose a reason for hiding this comment

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

+1

@kou kou merged commit d989191 into apache:main Feb 10, 2024
7 checks passed
@kou kou removed the awaiting merge Awaiting merge label Feb 10, 2024
@github-actions github-actions bot added the awaiting merge Awaiting merge label Feb 10, 2024
Copy link

After merging your PR, Conbench analyzed the 3 benchmarking runs that have been run so far on merge-commit d989191.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details.

@amoeba
Copy link
Member Author

amoeba commented Feb 10, 2024

Thanks @kou.

dgreiss pushed a commit to dgreiss/arrow that referenced this pull request Feb 19, 2024
…ache#39989)

### Rationale for this change

basic_arrow.rst had two minor issues:
- It used `’` (U+2019) instead of `'`
- While editing, I found it wasn't whitespace normalized

### What changes are included in this PR?

- `’` replaced with `'`
- Whitespace has been normalized

### Are these changes tested?

No

### Are there any user-facing changes?

Just docs.

Authored-by: Bryce Mecum <petridish@gmail.com>
Signed-off-by: Sutou Kouhei <kou@clear-code.com>
zanmato1984 pushed a commit to zanmato1984/arrow that referenced this pull request Feb 28, 2024
…ache#39989)

### Rationale for this change

basic_arrow.rst had two minor issues:
- It used `’` (U+2019) instead of `'`
- While editing, I found it wasn't whitespace normalized

### What changes are included in this PR?

- `’` replaced with `'`
- Whitespace has been normalized

### Are these changes tested?

No

### Are there any user-facing changes?

Just docs.

Authored-by: Bryce Mecum <petridish@gmail.com>
Signed-off-by: Sutou Kouhei <kou@clear-code.com>
thisisnic pushed a commit to thisisnic/arrow that referenced this pull request Mar 8, 2024
…ache#39989)

### Rationale for this change

basic_arrow.rst had two minor issues:
- It used `’` (U+2019) instead of `'`
- While editing, I found it wasn't whitespace normalized

### What changes are included in this PR?

- `’` replaced with `'`
- Whitespace has been normalized

### Are these changes tested?

No

### Are there any user-facing changes?

Just docs.

Authored-by: Bryce Mecum <petridish@gmail.com>
Signed-off-by: Sutou Kouhei <kou@clear-code.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants