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

0.3.2 release + docs cleanup #185

Merged
merged 2 commits into from
Feb 2, 2024
Merged

0.3.2 release + docs cleanup #185

merged 2 commits into from
Feb 2, 2024

Conversation

miki725
Copy link
Contributor

@miki725 miki725 commented Feb 1, 2024

Issue

chalk repo has outdated docs which is confusing where docs should be fixed

Description

  • most of the docs were out of date and just added to the confusion where a doc should be updated - in this repo or in the docs site repo
  • during release process docs will be copied to chalk so that chalk binary can ship with embedded docs as expected.
  • moved release notes to CHANGELOG.md in the root of the repo. This is a common pattern in GitHub and will make discovering changelog in the repo a lot easier. To be able to embed it in the chalk binary, make ensures to copy it to src/docs on build time.

Testing

no functional change. just build process change

else:
let toCheck = [arg, "core-" & arg, "howto-" & arg, "guide" & arg]
let toCheck = [arg, arg & ".md" & "core-" & arg, "howto-" & arg, "guide" & arg]
Copy link
Contributor

Choose a reason for hiding this comment

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

are you missing a comma , here? i think this line should be as follows correct? With a , after the new item of arg & ".md" you are looking to match on ?

let toCheck = [arg, arg & ".md", & "core-" & arg, "howto-" & arg, "guide" & arg]

Copy link
Contributor Author

Choose a reason for hiding this comment

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

good spot. thanks. updated

Copy link
Contributor

@MyNameIsMeerkat MyNameIsMeerkat left a comment

Choose a reason for hiding this comment

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

Looks good but I think there may be one small typo mistake in your changes to cmd_help.nim, think you are missing a comma , after the new item you inserted into the list. As currently written two adjacent list items get concatenated

* most of the docs were out of date and just added to the confusion
  where a doc should be updated - in this repo or in the docs site repo
* during release process docs will be copied to chalk so that
  chalk binary can ship with embedded docs as expected.
* moved release notes to `CHANGELOG.md` in the root of the repo.
  This is a common pattern in GitHub and will make discovering
  changelog in the repo a lot easier.
  To be able to embed it in the chalk binary, `make`
  ensures to copy it to `src/docs` on build time.
MyNameIsMeerkat
MyNameIsMeerkat previously approved these changes Feb 2, 2024
Copy link
Contributor

@MyNameIsMeerkat MyNameIsMeerkat left a comment

Choose a reason for hiding this comment

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

Commas looking good to me :D

@miki725 miki725 changed the title refactor: removing embedded docs 0.3.2 release + docs cleanup Feb 2, 2024
@miki725 miki725 marked this pull request as ready for review February 2, 2024 19:52
@miki725 miki725 requested a review from viega as a code owner February 2, 2024 19:52
Copy link
Contributor

@viega viega left a comment

Choose a reason for hiding this comment

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

👋📜

@miki725 miki725 merged commit 910b8a3 into main Feb 2, 2024
2 checks passed
@miki725 miki725 deleted the ms/docs branch February 2, 2024 19:58
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.

3 participants