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

Issue: Add Essential Documentation for Hacktoberfest Eligibility #9

Open
sanjaysah101 opened this issue Oct 16, 2024 · 0 comments
Open
Labels
ansopedia documentation Improvements or additions to documentation good first issue Good for newcomers hacktoberfest

Comments

@sanjaysah101
Copy link
Collaborator

Description

To make the repository eligible for Hacktoberfest and encourage contributions from the open-source community, add essential documentation pages. These pages will help new contributors understand the project, how to contribute, and the guidelines for participation.

Tasks

  1. Create README.md:

    • Provide an overview of the project, including its purpose, features, and technologies used.
    • Add sections such as:
      • Project Introduction
      • Getting Started (installation and setup instructions)
      • Usage Instructions (how to run the project locally)
      • API Reference (if applicable)
      • Contributing Guidelines
      • License Information
    • Include badges for Hacktoberfest participation, build status, and license.
  2. Create CONTRIBUTING.md:

    • Provide clear instructions on how to contribute to the repository.
    • Include the following sections:
      • How to fork and clone the repository.
      • Branch naming conventions (e.g., feature/, bugfix/, docs/).
      • How to create a pull request (PR).
      • Code formatting and style guide (e.g., Prettier, ESLint).
      • Link to CODE_OF_CONDUCT.md.
  3. Create CODE_OF_CONDUCT.md:

    • Establish community guidelines to ensure a welcoming and inclusive environment for contributors.
    • Use the Contributor Covenant template as a starting point.
    • Include guidelines on expected behaviour and how to report issues.
  4. Create LICENSE:

    • Choose an appropriate open-source license (e.g., MIT, Apache 2.0) to clarify how others can use the project.
    • Add the license text to the LICENSE file.
  5. Update .github/ISSUE_TEMPLATE.md (Optional):

    • Create a template for submitting issues to ensure all necessary details are included (e.g., description, steps to reproduce, expected behaviour).
    • This can help maintain consistency in issue reports and make it easier for contributors to get started.
  6. Update .github/PULL_REQUEST_TEMPLATE.md (Optional):

    • Create a template for pull requests that includes sections such as:
      • What changes have been made?
      • Screenshots (if applicable).
      • Related issue or task.
      • Checklist for tests and code quality checks.

Acceptance Criteria

  • README.md includes a detailed overview of the project, contributing instructions, and a Hacktoberfest badge.
  • CONTRIBUTING.md outlines steps to contribute, PR process, and coding standards.
  • CODE_OF_CONDUCT.md is based on the Contributor Covenant and outlines acceptable behaviour.
  • LICENSE file is added with the chosen license.
  • Optional: Issue and PR templates are available to guide contributors.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ansopedia documentation Improvements or additions to documentation good first issue Good for newcomers hacktoberfest
Projects
None yet
Development

No branches or pull requests

1 participant