diff --git a/docs/deployment.md b/docs/deployment.md new file mode 100644 index 0000000..6d24dc3 --- /dev/null +++ b/docs/deployment.md @@ -0,0 +1,11 @@ +# Deployment + +Bare minimum installation requires a database and an API. Then you can use any way you like to connect to the API. +We provide Telegram bot and raw HTTP for that now, but Discord bot and CLI are planned too. + +Here is how the "normal" deployment process looks like: + +1. Install the requirements [[API](api/installation.md#requirements)/[Telegram](bot_telegram/installation.md#requirements)] +2. Install the API server [[Guide](api/installation.md)] +3. Install the client/bot of your linking [[Telegram](bot_telegram/installation.md)] +4. Fill the API/bot with the data [[API](api/feeding-data.md)/[Telegram](bot_telegram/feeding-data.md)] diff --git a/docs/index.md b/docs/index.md index c50151d..5a98193 100644 --- a/docs/index.md +++ b/docs/index.md @@ -13,15 +13,3 @@ We provide chatbots as clients. These bots provide the access to the data stored After seeing that most cities and villages around only offer proprietary software/websites or even no digital information about garbage collection at all, it was decided to develop an own solution to this problem by storing the data in a database and then show the data the way it is helpful for the end-user. - -## Deployment - -Bare minimum installation requires a database and an API. Then you can use any way you like to connect to the API. -We provide Telegram bot and raw HTTP for that now, but Discord bot and CLI are planned too. - -Here is how the "normal" deployment process looks like: - -1. Install the requirements [[API](api/installation.md#requirements)/[Telegram](bot_telegram/installation.md#requirements)] -2. Install the API server [[Guide](api/installation.md)] -3. Install the client/bot of your linking [[Telegram](bot_telegram/installation.md)] -4. Fill the API/bot with the data [[API](api/feeding-data.md)/[Telegram](bot_telegram/feeding-data.md)] diff --git a/docs/start-using.md b/docs/start-using.md new file mode 100644 index 0000000..d780cd9 --- /dev/null +++ b/docs/start-using.md @@ -0,0 +1,17 @@ +# Start using + +There are two common usage scenarios: using public instance and deploying your own. + +## Using public instance + +While limited in coverage, public instance offers the access to the latest stable version of the API and chat-bots. + +* [Public API](https://api.garbagebot.eu) +* [Public Telegram Bot](https://t.me/GarbageReminder_Bot) + +You can find out more about public instance in the [Public instance](community/public/index.md) section. + +## Deploying own instance + +For more personalized experience, you can deploy your own API and clients wherever you want to. +Follow the [deployment guide](deployment.md) for detailed instructions. diff --git a/mkdocs.yml b/mkdocs.yml index d8d4ca3..0df7409 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -4,6 +4,8 @@ repo_name: GarbageReminder nav: - Home: - index.md + - Start using: start-using.md + - Deployment: deployment.md - API: - api/index.md - Installation: api/installation.md @@ -77,21 +79,21 @@ theme: palette: - media: "(prefers-color-scheme)" toggle: - icon: material/link + icon: material/brightness-auto name: Switch to light mode - media: "(prefers-color-scheme: light)" scheme: default primary: custom accent: custom toggle: - icon: material/toggle-switch + icon: material/brightness-7 name: Switch to dark mode - media: "(prefers-color-scheme: dark)" scheme: slate primary: custom accent: custom toggle: - icon: material/toggle-switch-off + icon: material/brightness-5 name: Switch to system preference font: text: Roboto