doc: build/config/settings fix confusing descriptions

[yf13]

rearrange point 2 as part of point 1, then update order of following points

[nordicjm]

Though please fix the commit message, remove the link to the issue and fix the commit message as per https://docs.zephyrproject.org/latest/contribute/guidelines.html#commit-message-guidelines

[yf13]

How can I continue editing the commit message from within web browser?

[nordicjm]

How can I continue editing the commit message from within web browser?

You need to do it from command line with git

[tejlmand]

Thanks for your contribution.
The changes looks good, but you need to rebase your commit and get rid of the merge-commit.

See more here: https://docs.zephyrproject.org/latest/contribute/guidelines.html#contribution-workflow

[kartben]

Thanks for the PR!
Please see my comment, and use git commit --amend --author="Author Name <[email protected]>" to fix your current commit so that it has the same author as the one specified in the Signed-off-by entry. Based on how much you want to actually exercise your git skills w.r.t rebasing, and because it's a pretty small change, you might find it easier to reset your branch to main and work your way through the two commits by re-starting form scratch though.
Thanks again!

[yf13]

use git commit --amend --author="Author Name <[email protected]>" to fix your current commit so that it has the same author as the one specified in the Signed-off-by entry.

this is fixed in my latest push.

[yf13]

Though please fix the commit message, remove the link to the issue and fix the commit message as per https://docs.zephyrproject.org/latest/contribute/guidelines.html#commit-message-guidelines

commit messages have been fixed in my latest push.

[yf13]

@kartben @tejlmand it seems that there are two approvals for this PR so far. As I am not authorized to merge this PR, please teach what I can do to move ahead. Should I simply click "close with comment" button ? I guess it might just close the conversations which doesn't seem necessary.

[kartben]

@kartben @tejlmand it seems that there are two approvals for this PR so far. As I am not authorized to merge this PR, please teach what I can do to move ahead. Should I simply click "close with comment" button ? I guess it might just close the conversations which doesn't seem necessary.

Please don't close it! Next step is for one of our release engineers to do the merge, which should happen momentarily now that I have set the target milestone to 3.5.
Thanks!

[github-actions]

Hi @yf13!
Congratulations on getting your very first Zephyr pull request merged 🎉🥳. This is a fantastic achievement, and we're thrilled to have you as part of our community!

To celebrate this milestone and showcase your contribution, we'd love to award you the Zephyr Technical Contributor badge. If you're interested, please claim your badge by filling out this form: Claim Your Zephyr Badge.

Thank you for your valuable input, and we look forward to seeing more of your contributions in the future! 🪁