Docs: Images are broken and unclear what permissions need to set

[glensc]

https://docs.miscord.net/other/creating-a-discord-bot

also, the instructions are outdated, discord have renamed buttons and ui.

also, the page should be made uisable without screenshots too, i.e indicate in text wbat's in screenshot:

Permissions:

[screenshot of the list of permissions]

yet, unlcear without pictures what permissions need to be enabled...

[glensc]

Seems the images were hosted on https://static.bjorn.ml/miscord-wiki-screenshots/ which is now dead.

and the origin resides in:

• https://github.com/miscord/docs/blob/7dde93eb4e1fbed0e94658b69cde6de353daaa22/other/creating-a-discord-bot.md

[glensc]

I found some images in .gitbook dir:

• https://github.com/miscord/docs/tree/7dde93eb4e1fbed0e94658b69cde6de353daaa22/.gitbook/assets

why not put everything there?

[ptrcnull]

The original images are long lost after a server migration, I'd consider linking to someone else's tutorial and just indicate which permissions need to be enabled for Miscord to work.

[glensc]

How do you edit https://docs.miscord.net/other/creating-a-discord-bot?

I see it points to githu repo:

• https://github.com/miscord/docs/blob/master/other/creating-a-discord-bot.md

but seems that repo is managed by gitbook, but no info how to contribute to gitbook or even where that gitbook is....

[ptrcnull]

Well, you answered your own question, changing files in that repo will update the GitBook.

[glensc]

@ptrcnull so, sending PR to docs repo is the way to contribute to https://docs.miscord.net?

as the commits look like these originate from an external system, not via github pull requests:

• https://github.com/miscord/docs/commits/master

I don't know how the gitbook works, or how contributing to gitbook goes

[ptrcnull]

I use GitBooks' internal editor, but committing to the repo is fine too.

[glensc]

I assume GitBook does not have open contributing model like github, otherwise you've already pointed to it?

[ptrcnull]

Well, GitBooks is just a fancy wrapper over Markdown and Git(Hub), I could just commit to the repo directly