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 docs & examples #2

Merged
merged 1 commit into from
Aug 28, 2021
Merged

fix docs & examples #2

merged 1 commit into from
Aug 28, 2021

Conversation

joseluis
Copy link
Contributor

Hi! first of all thank for creating this wonderful crate. I'm learning to work with color and I'm very happy having found your project, since it has a lot of depth and growth potential, while being simple to use in a way that I like very much.

While I was learning to use it I realized I could help fixing some things: three examples that didn't compile, some typos & links and I also limited the doc line lenghts on a couple of source files to make them easier to be read from the source files. More specifically:

  • in lib.rs:
    • limit the doc line length.
    • reformat the "further resources" section.
    • add an inner link in the first paragraph to the first resource.
    • change the phrase "all colors in Ark will now be" to "all colors are".
    • add links to spaces & states modules in "Overview" section.
    • fix typos (charcter, acces, A you).
    • fix doc examples:
      • encoded.to_u8()encoded.to_u8().raw.
      • color::srgb_u8(225, 200, 86)color::srgb_u8(225, 200, 86).to_f32().
  • in traits.rs:
    • fix doc example:
      • color::srgb_u8(225, 200, 86)color::srgb_u8(225, 200, 86).to_f32().
    • limit the doc line length.
    • fix typos (howver).

I could've kept going on but I didn't wanted to intrude too much. I hope you like it or at least don't mind my PR, and please feel free to accept or reject it or ask for any changes you want, or anything.

- in `lib.rs`:
  - limit the doc line length to 99 chars.
  - reformat the "further resources" section.
  - add an inner link in the first paragraph to the first resource.
  - change the phrase "all colors in Ark will now be" to "all colors are".
  - add links to `spaces` & `states` modules in "Overview" section.
  - fix typos (*charcter*, *acces*, *A you*).
  - fix doc examples:
    - `encoded.to_u8()` → `encoded.to_u8().raw`.
    - `color::srgb_u8(225, 200, 86)` → `color::srgb_u8(225, 200, 86).to_f32()`.
- in `traits.rs`:
  - fix doc example:
    - `color::srgb_u8(225, 200, 86)` → `color::srgb_u8(225, 200, 86).to_f32()`.
  - limit the doc line length to 99 chars.
  - fix typos (*howver*).
@fu5ha
Copy link
Owner

fu5ha commented Aug 28, 2021

Thanks so much! These were all things on my list to do before next RC release but didn't have time to clean it up yet :)

@fu5ha
Copy link
Owner

fu5ha commented Aug 28, 2021

The ci failure isn't your fault so merging anyway.

@fu5ha fu5ha merged commit 86f95ba into fu5ha:main Aug 28, 2021
@joseluis joseluis deleted the fix-docs branch August 29, 2021 07:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants