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

[docs] Close Hacktoberfest docs tickets with fixes for Vale issues #848

Merged
merged 28 commits into from
Nov 5, 2024

Conversation

stichbury
Copy link
Contributor

@stichbury stichbury commented Nov 4, 2024

Description

A set of changes to the language of the docs to fix some issues that typically complicate the language. To turn on all Vale suggestions/warnings, I dropped the word "leverage" into a page of docs. It's like a bomb went off, and all the niggles and grievances that Vale was holding onto were surfaced.

  • Most of them were arguable, but ideally if we can avoid "allow" when we mean "enable" and "provide" when we mean "supply" or "give" then we're helping our users parse the docs a little faster.

  • I turned off Vale in the FAQs page as that's rather promotional (it takes the old messaging from the readme)

  • A few issues with Vizro-AI docs in terms of readability: I will take a spin through these docs while @lingyielia is around this week to make sure any further tweaks (beyond what I've done here just to satisfy Vale) don't break the meaning.

Screenshot

Notice

  • I acknowledge and agree that, by checking this box and clicking "Submit Pull Request":

    • I submit this contribution under the Apache 2.0 license and represent that I am entitled to do so on behalf of myself, my employer, or relevant third parties, as applicable.
    • I certify that (a) this contribution is my original creation and / or (b) to the extent it is not my original creation, I am authorized to submit this contribution on behalf of the original creator(s) or their licensees.
    • I certify that the use of this contribution as authorized by the Apache 2.0 license does not violate the intellectual property rights of anyone else.
    • I have not referenced individuals, products or companies in any commits, directly or indirectly.
    • I have not added data or restricted code in any commits, directly or indirectly.

@stichbury stichbury changed the title [docs] Close Hacktoberfest docs tickets with fixes for Vale issues [docs] [DRAFT] Close Hacktoberfest docs tickets with fixes for Vale issues Nov 4, 2024
Copy link
Contributor

github-actions bot commented Nov 4, 2024

View the example dashboards of the current commit live on PyCafe ☕ 🚀

Updated on: 2024-11-05 13:17:54 UTC
Commit: cf72f8c

Link: vizro-core/examples/dev/

Link: vizro-core/examples/scratch_dev

Link: vizro-core/examples/visual-vocabulary/

@github-actions github-actions bot added the Vizro-AI 🤖 Issue/PR that addresses Vizro-AI package label Nov 4, 2024
@stichbury stichbury changed the title [docs] [DRAFT] Close Hacktoberfest docs tickets with fixes for Vale issues [docs] [READY] Close Hacktoberfest docs tickets with fixes for Vale issues Nov 4, 2024
@stichbury stichbury self-assigned this Nov 4, 2024
@stichbury stichbury removed the Vizro-AI 🤖 Issue/PR that addresses Vizro-AI package label Nov 4, 2024
@stichbury stichbury added the Docs 🗒️ Issue for markdown and API documentation label Nov 4, 2024
@stichbury stichbury marked this pull request as ready for review November 4, 2024 17:55
@Joseph-Perkins
Copy link
Contributor

Looks good to me!

(I added a comment around one word, though it might still be fine to accept the existing wording there, if that is preferred)

Copy link
Contributor

@Joseph-Perkins Joseph-Perkins left a comment

Choose a reason for hiding this comment

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

Approving in advance 👍 (in case it is determined that the existing wording is acceptable)

Copy link
Contributor

@lingyielia lingyielia left a comment

Choose a reason for hiding this comment

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

LGTM!

@github-actions github-actions bot added the Vizro-AI 🤖 Issue/PR that addresses Vizro-AI package label Nov 5, 2024
@stichbury stichbury changed the title [docs] [READY] Close Hacktoberfest docs tickets with fixes for Vale issues [docs] Close Hacktoberfest docs tickets with fixes for Vale issues Nov 5, 2024
@stichbury stichbury enabled auto-merge (squash) November 5, 2024 13:18
@stichbury stichbury merged commit 812acd8 into main Nov 5, 2024
37 checks passed
@stichbury stichbury deleted the docs/clear-vale-issues branch November 5, 2024 13:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Docs 🗒️ Issue for markdown and API documentation Vizro-AI 🤖 Issue/PR that addresses Vizro-AI package
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants