diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 412f734..fec5bd4 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -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. @@ -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 @@ -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. @@ -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. @@ -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. @@ -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. @@ -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)** diff --git a/tutorials/Graph World/advance.ipynb b/tutorials/Graph World/advance.ipynb index c2aa229..10fcafe 100644 --- a/tutorials/Graph World/advance.ipynb +++ b/tutorials/Graph World/advance.ipynb @@ -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).*" ] }, { @@ -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", "> " ] }, @@ -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." ] }, { @@ -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." ] }, { @@ -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": { diff --git a/tutorials/Graph World/beginner.ipynb b/tutorials/Graph World/beginner.ipynb index db554a9..c041877 100644 --- a/tutorials/Graph World/beginner.ipynb +++ b/tutorials/Graph World/beginner.ipynb @@ -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).*" ] }, { @@ -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", "> " ] }, @@ -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." ] }, { @@ -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." ] }, { diff --git a/tutorials/Grid World/advance.ipynb b/tutorials/Grid World/advance.ipynb index 00f39f4..9ebc7ec 100644 --- a/tutorials/Grid World/advance.ipynb +++ b/tutorials/Grid World/advance.ipynb @@ -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).*" ] }, { @@ -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." ] }, { @@ -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." ] }, { @@ -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!" ] diff --git a/tutorials/Grid World/beginner.ipynb b/tutorials/Grid World/beginner.ipynb index fde3a6c..b409965 100644 --- a/tutorials/Grid World/beginner.ipynb +++ b/tutorials/Grid World/beginner.ipynb @@ -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).*" ] }, { @@ -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." ] }, { @@ -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." ] }, { diff --git a/tutorials/Tree World/advance.ipynb b/tutorials/Tree World/advance.ipynb index e88b321..2c2225c 100644 --- a/tutorials/Tree World/advance.ipynb +++ b/tutorials/Tree World/advance.ipynb @@ -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).*" ] }, { @@ -81,7 +81,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 tree along with world creation. You can access each node and tree 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", "> " ] }, @@ -289,7 +289,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." ] }, { @@ -737,7 +737,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." ] }, { @@ -874,7 +874,7 @@ "source": [ "This covers all the required features and knowledge required to create simulations for Tree 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!" ] diff --git a/tutorials/Tree World/beginner.ipynb b/tutorials/Tree World/beginner.ipynb index 937bc89..16c9be3 100644 --- a/tutorials/Tree World/beginner.ipynb +++ b/tutorials/Tree World/beginner.ipynb @@ -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).*" ] }, { @@ -83,7 +83,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 tree along with world creation. You can access each node and tree 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", "> " ] }, @@ -248,7 +248,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." ] }, { @@ -688,7 +688,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." ] }, { diff --git a/tutorials/quickGuid.ipynb b/tutorials/quickGuid.ipynb index 905ba0f..fd4cbf4 100644 --- a/tutorials/quickGuid.ipynb +++ b/tutorials/quickGuid.ipynb @@ -995,7 +995,7 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "For more information and better understanding refer to [Tutorial]() section or you get more information about the methods or the modules please refer to the [API Reference]() section.\n", + "For more information and better understanding refer to [Tutorial](https://harrionparrix.github.io/traversecraft/user-guide/index.html) section or you get more information about the methods or the modules please refer to the [API Reference](https://harrionparrix.github.io/traversecraft/references/world/World.html) section.\n", "\n", "Thank You!" ]