stm32-cmake icon indicating copy to clipboard operation
stm32-cmake copied to clipboard

README tweaks

Open robamu opened this issue 4 years ago • 4 comments

  1. Additional example for HAL usage with the H7 family using two cores
  2. HTML ID achors for headings added
  3. Some minor formatting improvements and line breaks
  4. Additional usage example for setting the toolchain file

robamu avatar Aug 08 '21 14:08 robamu

Hi,

I personally think that splitting the line like this does not bring any value for a maintainer (The line break changes does not github rendering). Maybe It does, but I cannot see it. Some cleaning is needed see #270, but none it's actually done here. I think it's better to close this PR without merging it.

Hish15 avatar Jun 12 '22 11:06 Hish15

Do you want to discard all the suggested changes? The anchors are useful to add cross-references inside the README and I think some of the additions increase the usability of the project (e.g. example of hardcoding the toolchain file in CMakeLists.txt to prevent setting the same one all the time).

About the line breaks: You don't see them in github, but I think it's nicer for someone who reads / edits them in a text editor

robamu avatar Jun 13 '22 16:06 robamu

You are right on the lines breaks, as I said myself it does not change the generated html file. We can keep them.

The Usage section at the beginning of the file state that you can add multiple vars in different ways, and links to the exemples are provided. CMAKE_TOOLCHAIN_FILE is not in the list of those vars! It's assumed that people will know. Lets add there instead of at the end.

Hish15 avatar Jun 13 '22 19:06 Hish15

I moved the explanation to the top

robamu avatar Jul 08 '22 18:07 robamu