Skip to content

Commit

Permalink
Merge pull request #67 from srajan-kiyotaka/sracho
Browse files Browse the repository at this point in the history
fix broken links.
  • Loading branch information
srajan-kiyotaka authored Jun 24, 2024
2 parents 46909fd + c52d7f6 commit b362149
Show file tree
Hide file tree
Showing 8 changed files with 49 additions and 42 deletions.
34 changes: 18 additions & 16 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Contributing to TraverseCraft

We welcome you to get more involved with the TraverseCraft project! If you are new to contributing, we recommend that you first read our [contributing guide](). If you are contributing code or documentation, please follow our guides for setting up and managing a development environment and workflow. For code, documentation, or triage, please follow the corresponding [contribution guidelines]().
We welcome you to get more involved with the TraverseCraft project! If you are new to contributing, we recommend that you first read our [contributing guide](https://harrionparrix.github.io/traversecraft/contribute/contribution-guide.html). If you are contributing code or documentation, please follow our guides for setting up and managing a development environment and workflow. For code, documentation, or triage, please follow the corresponding [contribution guidelines](https://harrionparrix.github.io/traversecraft/contribute/index.html).

## [Ways to Contribute to TraverseCraft]()
## [Ways to Contribute to TraverseCraft](https://harrionparrix.github.io/traversecraft/contribute/ways-to-contribute.html)

### 1. Optimizing and Refactoring Code
Improve the performance and maintainability of TraverseCraft.
Expand All @@ -19,18 +19,18 @@ Identify and resolve issues to improve TraverseCraft stability.
### 5. Requesting and Implementing New Features
Suggest and add new functionalities to the project.

## [Contribution Types]()
## [Contribution Types](https://harrionparrix.github.io/traversecraft/contribute/index.html)

### [Bug Reports]()
### [Bug Reports](https://github.com/srajan-kiyotaka/TraverseCraft/issues/new?assignees=&labels=bug&projects=&template=bug_report.md&title=%5BBUG%5D)
Report bugs to help us improve TraverseCraft. Please provide detailed information about the issue and steps to reproduce it.

### [New Feature Requests]()
### [New Feature Requests](https://github.com/srajan-kiyotaka/TraverseCraft/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.md&title=%5BFEATURE%5D)
Suggest new features to enhance TraverseCraft. Provide a clear description and potential use cases.

### [Documentation Updates]()
### [Documentation Updates](https://github.com/srajan-kiyotaka/TraverseCraft/issues/new?assignees=&labels=documentation&projects=&template=documentation-template.md&title=%5BDOCUMENTATION%5D)
Help us keep the documentation up-to-date and clear. Report any issues or submit changes directly.

## Setting Up the Environment
## [Setting Up the Environment for Development](https://harrionparrix.github.io/traversecraft/contribute/dev-setup.html)

### Manually

Expand Down Expand Up @@ -91,7 +91,7 @@ Help us keep the documentation up-to-date and clear. Report any issues or submit
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```

## Testing Guidelines
## [Testing Guidelines](https://harrionparrix.github.io/traversecraft/contribute/testing.html)

1. **Setting Up the Testing Environment**
- Ensure all necessary dependencies are installed and the testing framework is configured.
Expand All @@ -114,7 +114,7 @@ Help us keep the documentation up-to-date and clear. Report any issues or submit
7. **Best Practices**
- Write atomic, repeatable tests with clear assertions to maintain code quality.

## Write Documentation
## [Write Documentation](https://harrionparrix.github.io/traversecraft/contribute/documentation.html)

1. **Method or Feature Docstring Update**
- Whenever a new method or feature is added, ensure that the corresponding docstring is updated. This maintains the readability and reliability of the codebase.
Expand All @@ -128,7 +128,7 @@ Help us keep the documentation up-to-date and clear. Report any issues or submit
4. **Requesting Website Update**
- Whenever a new method or feature is added, ensure that a request is made to update the project's website with the new feature.
## Pull Request Guidelines
## [Pull Request Guidelines](https://harrionparrix.github.io/traversecraft/contribute/pull-requests.html)
1. **Title and Description**
- Ensure that the pull request has a clear and concise title, along with a detailed description of the changes being made. This helps reviewers understand the context and purpose of the pull request.
Expand Down Expand Up @@ -160,7 +160,7 @@ Help us keep the documentation up-to-date and clear. Report any issues or submit
- We encourage all community members to engage actively in discussions, provide feedback, and support fellow contributors and users.

- **Discussion**
- Join our [Discussions](LINK_TO_DISCUSSIONS_PAGE) page to ask questions, share ideas, and stay updated on project announcements.
- Join our [Discussions](https://github.com/srajan-kiyotaka/TraverseCraft/discussions) page to ask questions, share ideas, and stay updated on project announcements.

- **Announcements**
- Important project updates, releases, and news are shared on our Discussions page. Stay informed and participate in discussions.
Expand All @@ -175,8 +175,10 @@ Help us keep the documentation up-to-date and clear. Report any issues or submit
For more information on how to contribute to TraverseCraft, please see the following sections:
- **[Contributing Guidelines](LINK_TO_CONTRIBUTING_GUIDELINES)**
- **[Setting Up for Development](LINK_TO_SETUP_GUIDE)**
- **[Testing Guidelines](LINK_TO_TESTING_GUIDELINES)**
- **[Write Documentation](LINK_TO_DOCUMENTATION_GUIDE)**
- **[Pull Request Guidelines](LINK_TO_PULL_REQUEST_GUIDELINES)**
- **[Contributing Guidelines](https://harrionparrix.github.io/traversecraft/contribute/contribution-guide.html)**
- **[Setting Up for Development](https://harrionparrix.github.io/traversecraft/contribute/dev-setup.html)**
- **[Testing Guidelines](https://harrionparrix.github.io/traversecraft/contribute/testing.html)**
- **[Write Documentation](https://harrionparrix.github.io/traversecraft/contribute/documentation.html)**
- **[Pull Request Guidelines](https://harrionparrix.github.io/traversecraft/contribute/pull-requests.html)**
- **[Contribute](https://harrionparrix.github.io/traversecraft/contribute/index.html)**
- **[Ways to Contribute](https://harrionparrix.github.io/traversecraft/contribute/ways-to-contribute.html)**
15 changes: 10 additions & 5 deletions tutorials/Graph World/advance.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@
"\n",
"> **Note:** *It is very important to call the right agent for the given world, otherwise the module will through an error. Each world behave differently and each agent is tailored for that world only.*\n",
"\n",
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the os type printed and your OS type matches. If it does't match please [report this]().*"
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the os type printed and your OS type matches. If it does't match please [report this](https://github.com/srajan-kiyotaka/TraverseCraft/issues/new?assignees=&labels=bug&projects=&template=bug_report.md&title=%5BBUG%5D).*"
]
},
{
Expand Down Expand Up @@ -80,7 +80,7 @@
"> **Note:** \n",
"> - *You only have to pass node IDs which can be a `char`, `str`, `int` and the library will use it's internal data nodes to create the Graph along with world creation. You can access each node and Graph information from the library itself. This will also be helpful if you further want to modify/customize the nodes. The keys mention above in the **world information** are only the necessary key's but there are other keys as well.*\n",
"> - *The position of each node will be the coordinates. The (0,0) coordinate is you screens top left corner. Please consider drawing the world on a paper before actually writing the world abstract information.*\n",
"> - *Please refer the [API Reference]() section for more information.*\n",
"> - *Please refer the [API Reference](https://harrionparrix.github.io/traversecraft/references/world/World.html) section for more information.*\n",
"> "
]
},
Expand Down Expand Up @@ -284,7 +284,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down Expand Up @@ -748,7 +748,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down Expand Up @@ -896,10 +896,15 @@
"source": [
"This covers all the required features and knowledge required to create simulations for Graph World.\n",
"\n",
"Next, please refer the [API Reference]() section for more details regarding each class and methods.\n",
"Next, please refer the [API Reference](https://harrionparrix.github.io/traversecraft/references/world/World.html) section for more details regarding each class and methods.\n",
"\n",
"Thanks!"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": []
}
],
"metadata": {
Expand Down
8 changes: 4 additions & 4 deletions tutorials/Graph World/beginner.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@
"\n",
"> **Note:** *It is very important to call the right agent for the given world, otherwise the module will through an error. Each world behave differently and each agent is tailored for that world only.*\n",
"\n",
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the OS type printed and your OS type matches. If it does't match please [report this]().*"
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the OS type printed and your OS type matches. If it does't match please [report this](https://github.com/srajan-kiyotaka/TraverseCraft/issues/new?assignees=&labels=bug&projects=&template=bug_report.md&title=%5BBUG%5D).*"
]
},
{
Expand Down Expand Up @@ -82,7 +82,7 @@
"> **Note:** \n",
"> - *You only have to pass node IDs which can be a `char`, `str`, `int` and the library will use it's internal data nodes to create the Graph along with world creation. You can access each node and Graph information from the library itself. This will also be helpful if you further want to modify/customize the nodes. The keys mention above in the **world information** are only the necessary key's but there are other keys as well.*\n",
"> - *The position of each node will be the coordinates. The (0,0) coordinate is you screens top left corner. Please consider drawing the world on a paper before actually writing the world abstract information.*\n",
"> - *Please refer the [API Reference]() section for more information.*\n",
"> - *Please refer the [API Reference](https://harrionparrix.github.io/traversecraft/references/world/World.html) section for more information.*\n",
"> "
]
},
Expand Down Expand Up @@ -244,7 +244,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down Expand Up @@ -697,7 +697,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down
8 changes: 4 additions & 4 deletions tutorials/Grid World/advance.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@
"\n",
"> **Note:** *It is very important to call the right agent for the given world, otherwise the module will through an error. Each world behave differently and each agent is tailored for that world only.*\n",
"\n",
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the os type printed and your OS type matches. If it does't match please [report this]().*"
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the os type printed and your OS type matches. If it does't match please [report this](https://github.com/srajan-kiyotaka/TraverseCraft/issues/new?assignees=&labels=bug&projects=&template=bug_report.md&title=%5BBUG%5D).*"
]
},
{
Expand Down Expand Up @@ -227,7 +227,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down Expand Up @@ -698,7 +698,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down Expand Up @@ -860,7 +860,7 @@
"source": [
"This covers all the required features and knowledge required to create simulations for Grid World.\n",
"\n",
"Next, please refer the [API Reference]() section for more details regarding each class and methods.\n",
"Next, please refer the [API Reference](https://harrionparrix.github.io/traversecraft/references/world/World.html) section for more details regarding each class and methods.\n",
"\n",
"Thanks!"
]
Expand Down
6 changes: 3 additions & 3 deletions tutorials/Grid World/beginner.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@
"\n",
"> **Note:** *It is very important to call the right agent for the given world, otherwise the module will through an error. Each world behave differently and each agent is tailored for that world only.*\n",
"\n",
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the os type printed and your OS type matches. If it does't match please [report this]().*"
"> **Remark:** *Don't worry if during the importing the library prints the OS Type. Actually the library uses some internal variables which are OS depended. It is necessary that the os type printed and your OS type matches. If it does't match please [report this](https://github.com/srajan-kiyotaka/TraverseCraft/issues/new?assignees=&labels=bug&projects=&template=bug_report.md&title=%5BBUG%5D).*"
]
},
{
Expand Down Expand Up @@ -190,7 +190,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down Expand Up @@ -636,7 +636,7 @@
"metadata": {},
"source": [
"## Help\n",
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website]() to get more information."
"If you want to know more information about any method, or variable, you can simple use the `help()` function to get more information. Or you can visit our official [website](https://harrionparrix.github.io/traversecraft/index.html) to get more information."
]
},
{
Expand Down
Loading

0 comments on commit b362149

Please sign in to comment.