Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 62 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# 📘 BRCDev Documentation Source

This repository contains the source files for the documentation hosted at [docs.brcdev.net](https://docs.brcdev.net/), generated using GitHub Pages.

## 🧭 Overview

The documentation provides comprehensive guides and API references for BRCDev's Minecraft plugins, including:

- **AuctionGUI**
- **Christmas**
- **Gangs**
- **PlayerShopGUI**
- **ShopGUI**

This repository serves as the central hub for maintaining and updating the documentation content.

## 🚀 Getting Started

To contribute or run the documentation locally:

1. **Clone the repository:**

```bash
git clone https://github.com/brcdev-minecraft/docs-brcdev-net.git
```

2. **Navigate to the project directory:**

```bash
cd docs-brcdev-net
```

3. **Install dependencies:**

Depending on the documentation framework used (e.g., MkDocs, Docusaurus), install the necessary dependencies. For example, if using MkDocs:

```bash
pip install mkdocs
```

4. **Serve the documentation locally:**

```bash
mkdocs serve
```

Then, open [http://localhost:8000](http://localhost:8000) in your browser to view the documentation.

*Note: Please adjust the above steps according to the specific tools and frameworks used in your project.*
Comment on lines +33 to +49
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. **Install dependencies:**
Depending on the documentation framework used (e.g., MkDocs, Docusaurus), install the necessary dependencies. For example, if using MkDocs:
```bash
pip install mkdocs
```
4. **Serve the documentation locally:**
```bash
mkdocs serve
```
Then, open [http://localhost:8000](http://localhost:8000) in your browser to view the documentation.
*Note: Please adjust the above steps according to the specific tools and frameworks used in your project.*

We aren't using mkdocs, we use docsify which handles all the hard work for us, probably not a need for this since contributors would only be looking at markdown files anyways?


## 🛠️ Contributing

Contributions are welcome! If you'd like to improve the documentation:

- Fork the repository.
- Create a new branch for your changes.
- Make your edits and commit them with clear messages.
- Push your changes to your forked repository.
- Submit a pull request detailing your changes.

For major changes or suggestions, please open an issue first to discuss your ideas.