Skip to content

Commit

Permalink
Merge pull request #78 from MIT-Emerging-Talent/Soultions-and-tests-f…
Browse files Browse the repository at this point in the history
…older-Readme

solutions and tests readme
  • Loading branch information
linahKhayri authored Jan 3, 2025
2 parents 945c028 + 0024045 commit aa6adae
Show file tree
Hide file tree
Showing 3 changed files with 60 additions and 0 deletions.
1 change: 1 addition & 0 deletions .markdownlint.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,3 +37,4 @@ MD048: # Code block style (consistent backticks)
# Disable some strict rules for beginners
MD024: false # Allow multiple headings with the same content
MD041: false # First line in a file being a top-level heading
MD033: false # allow inline html
22 changes: 22 additions & 0 deletions solutions/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,23 @@
# Solutions

Welcome to the **Solutions** directory of Group 24! This folder contains the implementations and solutions to the challenges or problems assigned to the group by its members.

## Directory Structure

- Each task or problem will have its own folder or file, clearly named for easy identification.
- Code solutions are typically written in python.

## Contribution Guidelines

1. Ensure your solution is optimized and well-documented.
2. Follow the coding standards outlined by the team.
3. Include comments in your code to explain key logic.
4. Test your solutions locally before submitting them.

## Status

- We continuously improve and refine our solutions. Please check for updates regularly!

## Contact

For questions or suggestions regarding the solutions, reach out to the team members.
37 changes: 37 additions & 0 deletions solutions/tests/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,38 @@
# Tests

This is the **Tests** directory of Group 24, dedicated to validating the solutions and ensuring the functionality and correctness of the implementations.

## Purpose

The tests are designed to:

1. Verify the correctness of solutions.
2. Ensure edge cases and special conditions are handled properly.
3. Maintain the reliability and robustness of the codebase.

## Directory Structure

- Each solution will have a corresponding test file or folder.
- Tests are categorized based on the problem/task they validate.

## Writing Tests

- Use consistent naming conventions for test files
- Follow the team's testing framework or tools (e.g., **PyTest**).
- Cover all edge cases, normal cases, and error cases.

## Running Tests

1. Navigate to this directory in your terminal.
2. Use the designated command for the testing framework
3. Ensure all tests pass before pushing changes.

## Contribution Guidelines

1. Write clear and concise test cases.
2. Ensure test cases are independent of each other.
3. Document the purpose of each test case in comments.

## Contact

If you encounter any issues with the tests or have suggestions for improvement, feel free to contact the team members or test maintainers.

0 comments on commit aa6adae

Please sign in to comment.