Skip to content

docs: improve time/base README Examples #1657

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

Merged

Conversation

Oneday12323
Copy link
Contributor

Resolves #1653 .
RFC: improve README examples of time/base namespace

Description

What is the purpose of this pull request?

This RFC proposes to enhance the README examples for the time/base namespace package. The current state of the namespace package READMEs features only minimal examples, which are not sufficiently informative nor do they showcase the functionality of the namespace effectively.

Given the project's development and organization have now stabilized, it's an opportune time to revisit these packages and enrich the README with comprehensive examples. These examples will better illustrate how to utilize the contents of the namespace, thereby aiding users in understanding and applying the package's functionalities.

Contributors to this enhancement can follow these steps:

  1. Browse through the time/base namespace to identify notable functions and packages.
  2. Update the "Examples" section of the README with detailed code blocks that demonstrate these features.
  3. Ensure that updated examples adhere to existing project conventions, such as ES5 syntax.
  4. Consider incorporating functionalities from other packages to make the examples more engaging and informative.

Related Issues

Does this pull request have any related issues?

None.

Questions

Any questions for reviewers of this pull request?

No questions at this time. I welcome any feedback on the proposed changes to the README examples.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

No additional information. The updates are focused on improving documentation through better examples, without altering the functionality of the time/base namespace.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

  • I have read and understood the Code of Conduct.
  • Searched for existing issues and pull requests to avoid duplication.
  • The issue name begins with RFC:

@stdlib-js/reviewers

Copy link
Contributor

@stdlib-bot stdlib-bot left a comment

Choose a reason for hiding this comment

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

👋 Hi there! 👋

And thank you for opening your first pull request! We will review it shortly. 🏃 💨

Copy link
Member

@Planeshifter Planeshifter 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, thanks!

For future reference, no reason to include the full RFC issue post in the PR description. And ensure your development environment is properly initialized (run make init after installation), as linting should have caught redeclaring the obj variable.

@Planeshifter Planeshifter changed the title RFC: improve time/base/README.md-Examples docs: improve time/base README Examples Mar 3, 2024
@Planeshifter Planeshifter merged commit 670a52d into stdlib-js:develop Mar 3, 2024
bad-in-coding pushed a commit to bad-in-coding/stdlib that referenced this pull request Mar 7, 2024
PR-URL: stdlib-js#1657
Resolves: stdlib-js#1653 

---------

Signed-off-by: Philipp Burckhardt <[email protected]>
Co-authored-by: Philipp Burckhardt <[email protected]>
Reviewed-by: Philipp Burckhardt <[email protected]>
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.

[RFC]: improve README examples of time/base namespace
3 participants