Coltensiemer / AWS_Learn

An AWS Quiz maker to practice for the AWS Cloud Certifications.
https://aws-learn.vercel.app
2 stars 0 forks source link

Restructure folder structure #16

Closed Coltensiemer closed 2 months ago

Coltensiemer commented 3 months ago

Here is the updated pull request template with checkboxes:


Pull Request: Update README to Contain Project Structure and Review 'lib' Folder Location

GitHub Issue:


Description

This PR addresses the enhancement of the project's documentation and the reorganization of the lib folder.

Objective:
  1. Update README to Contain Project Structure:

    • Enhance the comprehensiveness and usability of the project's documentation by updating the README file to include a detailed overview of the project structure.
  2. Review and Update 'lib' Folder Location:

    • Review the current location and structure of the lib folder and update its placement and contents to align with best practices and project organization standards.

Tasks:

Update README to Contain Project Structure:

  1. Introduction:

    • Add a project structure inside the README.
  2. Project Structure Overview:

    • Provide a high-level overview of the project's directory structure.
    • Include a tree diagram or list format to display the hierarchy of folders and files.
  3. Detailed Explanation:

    • For each major directory, provide a brief description of its purpose and contents.
    • Highlight key files and their roles within the project.
    • Mention any naming conventions or coding standards followed.

Review and Update 'lib' Folder Location:

  1. Review Current Structure:

    • Analyze the current location and contents of the lib folder.
    • Identify the purpose of the files and modules contained within it.
    • Assess whether the current structure follows best practices for project organization.
  2. Research Best Practices:

    • Investigate industry standards and best practices for organizing library or utility code in a project.
    • Consider different approaches and folder structures commonly used in similar projects.
  3. Plan New Structure:

    • Propose a new location and structure for the lib folder that aligns with best practices.
    • Ensure the proposed structure improves clarity and maintainability.
    • Include a detailed plan for relocating and reorganizing the contents of the lib folder.
  4. Update Project:

    • Move the lib folder to its new location as per the proposed structure.
    • Update import statements and references throughout the project to reflect the new location.
    • Refactor any code as necessary to adapt to the updated structure.
  5. Documentation:

    • Update the README file and any other relevant documentation to reflect the new lib folder structure.
    • Provide a clear explanation of the changes and the reasoning behind them.
    • Include instructions for contributors on where to place new library or utility code.

Benefits:


Requirements:


Acceptance Criteria:


Additional Information:


Note: This PR combines the changes for both the README update and the lib folder reorganization to ensure that the documentation and codebase are in sync with the proposed improvements.


vercel[bot] commented 3 months ago

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
aws-learn ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 2, 2024 8:27pm
Coltensiemer commented 3 months ago

@frontendops - During this I did refactor the structure of my components folders to match my app routes and I changed the components/shadcn folder to components/atomic. I performed end 2 end test locally and ran build to make sure everything worked.