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(readme): API documentation overhaul #716

Merged
merged 8 commits into from
Oct 26, 2023

Conversation

rharshit82
Copy link
Contributor

@rharshit82 rharshit82 commented Oct 14, 2023

Description

Refactored the Readme file into a more readable and standard readme

Related Issue

Closes #441.

Motivation and Context

How Has This Been Tested?

Screenshots (if appropriate):

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have added tests to cover my changes.
  • All new and existing tests passed.
  • If my change introduces a breaking change, I have added a ! after the type/scope in the title (see the Conventional Commits standard).

@rharshit82 rharshit82 changed the title basic refactoring done docs: Readme overhaul Oct 14, 2023
@rharshit82 rharshit82 marked this pull request as ready for review October 20, 2023 20:47
@rharshit82 rharshit82 marked this pull request as draft October 20, 2023 20:48
@sheerlox sheerlox changed the title docs: Readme overhaul docs(readme): API documentation overhaul Oct 21, 2023
Copy link
Collaborator

@sheerlox sheerlox left a comment

Choose a reason for hiding this comment

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

great PR, the rewording is very good!

I've created a commit on my fork to put all the suggestions I had (seemed easier than writing down everything in a review). all changes are obviously open to discussion!

you can view the diff here: rharshit82/node-cron@fix/readme-overhaul...sheerlox:node-cron:docs/readme/api-documentation-overhaul

if you'd like to integrate my commit in your branch, you can pick the patch file and apply it in your branch:

curl https://github.com/sheerlox/node-cron/commit/1d22cf136b5596d4ae2e43fed35d427b3c78579b.patch | git am

you can also just apply the changes (without creating the commit) by piping the patch into git apply instead of git am.

@rharshit82
Copy link
Contributor Author

rharshit82 commented Oct 21, 2023

Thanks @sheerlox I have added your commit. I was actually going to fix table of contents and refactor the readme more but your commit as done just that. Marking this PR ready for review !

@rharshit82 rharshit82 marked this pull request as ready for review October 21, 2023 15:11
docs(readme): minor capitalization added
sheerlox
sheerlox previously approved these changes Oct 21, 2023
@sheerlox
Copy link
Collaborator

lgtm, I'll let @intcreator take a look as well so he can make changes as he sees fit before merging.

Note: I've added two badges that are not yet functional: the CodeQL one will start working when #715 is merged, and the Discord badge needs a tweak in the Discord server settings (enable widget) to display the number of online members correctly.

@intcreator
Copy link
Collaborator

looks like you missed a checklist item 😛
image

@rharshit82
Copy link
Contributor Author

Sure added it. Didnt add it before since I thought its only for a code change that required a doc change.

Copy link
Collaborator

@intcreator intcreator left a comment

Choose a reason for hiding this comment

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

I have a few questions/requested changes, but overall I like it! I especially like...

  • addition of Discord badge (I enabled the widget so it shows a preview of online people too)
  • table of contents

(and I was just joking about the checklist item haha)

README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@rharshit82
Copy link
Contributor Author

Have made the requested changes. Feel free to make commits in this PR if needed @sheerlox

intcreator
intcreator previously approved these changes Oct 25, 2023
Copy link
Collaborator

@intcreator intcreator left a comment

Choose a reason for hiding this comment

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

I just added the Renovate badge. I think that's everything, looks good to me

@sheerlox sheerlox merged commit 23fb0a3 into kelektiv:main Oct 26, 2023
11 checks passed
@sheerlox sheerlox deleted the fix/readme-overhaul branch October 26, 2023 12:58
@sheerlox
Copy link
Collaborator

since we're planning on merging #751 today, I skipped the CI so we release them together under 3.1.5.

ncb000gt pushed a commit that referenced this pull request Oct 26, 2023
## [3.1.5](v3.1.4...v3.1.5) (2023-10-26)

### 🐛 Bug Fixes

* detect multiple zeros as an invalid step ([#743](#743)) [skip ci] ([b0bf677](b0bf677))
* re-add runOnce property to CronJob ([#751](#751)) ([a61d8c9](a61d8c9))

### 📚 Documentation

* **readme:** API documentation overhaul ([#716](#716)) [skip ci] ([23fb0a3](23fb0a3))

### ⚙️ Continuous Integrations

* **action:** update actions/setup-node action to v4 ([#749](#749)) ([ef850f3](ef850f3))

### ♻️ Chores

* **deps:** update dependency [@commitlint](https://github.com/commitlint)/cli to v18 ([#747](#747)) ([5ff1cf8](5ff1cf8))
* **deps:** update dependency sinon to v17 ([#748](#748)) ([9d61ff9](9d61ff9))
* **deps:** update linters ([7bdc726](7bdc726))
* improve ossf scorecard's score ([#715](#715)) [skip ci] ([1284df4](1284df4))
@ncb000gt
Copy link
Member

🎉 This PR is included in version 3.1.5 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

README API documentation overhaul
4 participants