Skip to content

Commit

Permalink
fix(content): phrasing/grammar pass on introduction page
Browse files Browse the repository at this point in the history
  • Loading branch information
shiftinv committed Dec 29, 2024
1 parent 1f4169b commit 657758c
Showing 1 changed file with 13 additions and 15 deletions.
28 changes: 13 additions & 15 deletions guide/docs/intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,26 +10,26 @@ Welcome! The purpose of this guide is to make your journey with `disnake` easier
developer just getting into coding Discord bots, or an advanced bot developer who has decided to proceed with `disnake`
as their library of choice.

The concept we will be going over, include:
The concepts this guide will be going over include:

- How to get started on working with bots;
- How to create and organize commands, using cogs/extensions;
- Working with databases (such as [`sqlite (aiosqlite)`][sqlite-docs] and [`mongodb (motor)`][motor-docs]);
- How to get started on working with bots
- How to create and organize commands, using cogs/extensions
- Working with databases (such as [`sqlite (aiosqlite)`][sqlite-docs] and [`mongodb (motor)`][motor-docs])
- Using the [`AutoShardedClient`](https://disnake.readthedocs.io/en/stable/api.html#disnake.AutoShardedClient) class
to shard your bot;
to shard your bot
- A plethora of examples with popular topics along with in-depth explanation, and much more!

[sqlite-docs]: https://aiosqlite.omnilib.dev/en/latest/
[motor-docs]: https://motor.readthedocs.io/en/stable/tutorial-asyncio.html

This guide will showcase the various features and events that our library has, while giving you an idea of how these
functions work together as well as how the syntax looks in production.
This guide will showcase the various features and events that the library has,
while giving you an idea of how these functions work together as well as how a project might look in production.

## Disclaimer

We appreciate the process of making Discord bots, but creating a bot with `disnake` requires a decent amount of
experience on working with Python and object-oriented programming. While you _can_ go forward and make a bot with little
to no knowledge of Python or programming, doing so will only hinder your progress and cause issues in the future.
to no knowledge of Python or programming, doing so may hinder your progress and cause issues in the future.

If you don't know Python but would like to learn more, here are a few resources to get you started:

Expand All @@ -40,21 +40,19 @@ If you don't know Python but would like to learn more, here are a few resources
programming experience.

An extensive list of these resources can be found on
[Python's official website](https://wiki.python.org/moin/BeginnersGuide/NonProgrammers). Once you're more experienced
with Python, you can come back here to get started!
[Python's official website](https://wiki.python.org/moin/BeginnersGuide/NonProgrammers). Once you feel
a little more experienced with Python, you can come back here to get started!

## Links & Credits

This guide is made using [**Docusaurus**](https://docusaurus.io/), a static site generator geared towards building
project documentation. The package utilized for Discord-like message elements is Danktuary's [`@discord-message-components/react`](https://www.npmjs.com/package/@discord-message-components/react).

The idea of building a guide that showcases the use of `disnake`'s syntax was inspired from
The idea of building a guide that showcases the use of `disnake`'s syntax and features was inspired from
[**Discord.js**](https://discord.js.org/), one of the most popular JavaScript Discord libraries; their guide can be
found [here](https://discordjs.guide/). The credit for the initial directory structure and articles, goes to them.
found [here](https://discordjs.guide/). The credit for the initial directory and articles structure goes to them.

Since this project started as members-only, the credits for a majority of the initial content go to our organization
members - **thesadru**, **shiftinv**, **Victorsitou**, **vcokltfre**, **m1raynee** and **AbhigyanTrips**. We also thank
to all contributors on the repository, who strive to make the guide better.
We also thank all contributors on the repository, who strive to make the guide better.

Lastly, a huge thanks to **you**, the members of the `disnake` community, for supporting our library and choosing us for
your bot development journey. We as the authors of this guide aim to familiarize users on coding Discord bots with our
Expand Down

0 comments on commit 657758c

Please sign in to comment.