Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add guides to Concord #109

Open
10 of 30 tasks
lcsmuller opened this issue Sep 30, 2022 · 12 comments
Open
10 of 30 tasks

Add guides to Concord #109

lcsmuller opened this issue Sep 30, 2022 · 12 comments
Assignees
Labels
documentation Improvements or additions to documentation enhancement New feature or request

Comments

@lcsmuller
Copy link
Collaborator

lcsmuller commented Sep 30, 2022

Describe the feature

This issue is for keeping track of the many guides that should help make Concord a more welcoming place to newcomers. If you got any suggestions, feel free to write them down below!

NOTE: all of the following should be added to docs/guides/

Acceptance criteria

  • Add installation & preparations guide
    • How to install concord
    • Setting up a bot application
    • Adding bot to servers
  • Getting the bot started
    • Setting up with the config.json files
    • Setting up with env variables
  • Miscellaneous
    • FAQ
    • Concord's async workflow
    • Concord's timers
    • Concord's caching
    • Concord's dispatcher
    • Sending attachments
    • Slash Commands
    • Message Components
    • Threads
    • Embeds
    • Reactions
    • Permissions
    • Gateway intents
    • Webhooks
    • Errors
    • Audit Logs
  • Other topics
    • Using a DB with concord
    • Debugging (GDB, Valgrind, ...)
    • Managing your bot process
    • Architecture
    • C99 syntax quirks used by Concord (with emphasis on Designated Initializers and Compound Literals)
    • Concord on old systems
    • Using an external SSL proxy
  • Internal
    • Gencodecs
    • Makefile build-system (explain BSD Make quirks)

Version

v2.1.0

@lcsmuller lcsmuller added documentation Improvements or additions to documentation enhancement New feature or request labels Sep 30, 2022
@lcsmuller lcsmuller pinned this issue Sep 30, 2022
@HackerSmacker HackerSmacker self-assigned this Sep 30, 2022
@lcsmuller lcsmuller self-assigned this Sep 30, 2022
@HackerSmacker
Copy link
Collaborator

I'll get most of these done, in addition to guides covering

  • Concord on a VAX (with native SSL)
  • Concord on Solaris 9
  • SSL certificate pinning with libcurl and Concord
  • Using Concord natively on Windows
  • Windows SSL API

lcsmuller added a commit that referenced this issue Sep 30, 2022
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 9, 2022
Adding the config.json related guides to the guides directory.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 10, 2022
Adding the config.json related guides to the guides directory.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 10, 2022
Adding the config.json related guides to the guides directory.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 10, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 10, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 10, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 10, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 11, 2022
Adding the config.json related guides to the guides directory.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 11, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 11, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 11, 2022
Adding the debugging guide md file.

Refereces Cogmasters#109
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 11, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 13, 2022
Adding the "env vars with concord" guide.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 13, 2022
Adding the "env vars with concord" guide.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 13, 2022
Adding the "env vars with concord" guide.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 15, 2022
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 15, 2022
Adding the debugging guide md file.

Refereces Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 15, 2022
Adding the "env vars with concord" guide.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
@lcsmuller lcsmuller linked a pull request Oct 15, 2022 that will close this issue
1 task
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 28, 2022
Adding slash commands guide, that will teach how to create (global and guild specific) slash commands, respond to them, and how delete them.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 28, 2022
Adding slash commands guide, that will teach how to create (global and guild specific) slash commands, respond to them, and how delete them.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 28, 2022
Adding slash commands guide, that will teach how to create (global and guild specific) slash commands, respond to them, and how delete them.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Oct 28, 2022
Adding slash commands guide, that will teach how to create (global and guild specific) slash commands, respond to them, and how delete them.

References Cogmasters#109
lcsmuller pushed a commit to ThePedroo/concord that referenced this issue Jan 18, 2023
Adding slash commands guide, that will teach how to create (global and guild specific) slash commands, respond to them, and how delete them.

References Cogmasters#109
ThePedroo added a commit to ThePedroo/concord that referenced this issue Jan 18, 2023
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue May 2, 2023
Adding the "using sqlite3 with concord" guide.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue May 2, 2023
Adding the debugging guide md file.

Refereces Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue May 2, 2023
Adding the "env vars with concord" guide.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue May 2, 2023
Adding the guide of how to install Concord on termux.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
ThePedroo added a commit to ThePedroo/concord that referenced this issue May 2, 2023
Adding the guide of how to use embeds with Concord.

References Cogmasters#109
Co-authored-by: Lucas Müller <[email protected]>
Co-authored-by: HackerSmacker
@Macintosh-Fan
Copy link

A question about a feature: how do I set a bot's status to do not disturb then back to online in C?

@lcsmuller
Copy link
Collaborator Author

You can do that with discord_update_presence(), here is an example for reference!

@Macintosh-Fan
Copy link

Thanks. And, is there a way to enable all intents?

@lcsmuller
Copy link
Collaborator Author

lcsmuller commented Jun 1, 2023

discord_add_intents() will do the trick, you can find some of the predefined intents here. If you want to enable all intents you may simply pass it a UINT64_MAX flag from stdint.h (doesn't work)

@Macintosh-Fan
Copy link

Macintosh-Fan commented Jun 1, 2023

discord_add_intents() will do the trick, you can find some of the predefined intents here. If you want to enable all intents you may simply pass it a UINT64_MAX flag from stdint.h

It immediately fails with that trick for some reason.

All intents should be good on the website-end of things:
image

@lcsmuller
Copy link
Collaborator Author

It immediately fails with that trick for some reason.

You got some logs? (make sure to enable logging at your config.json)

@Macintosh-Fan
Copy link

Macintosh-Fan commented Jun 2, 2023

It immediately fails with that trick for some reason.

You got some logs? (make sure to enable logging at your config.json)

Logging does not seem to be working with running clang main.c -o myBot -pthread -ldiscord -lcurl; ./myBot. "quiet" is also set to false in the log.

Though, at least using strerror, I get Policy not found.

@Macintosh-Fan
Copy link

It immediately fails with that trick for some reason.

You got some logs? (make sure to enable logging at your config.json)

Sorry, my bad; works differently than I thought.

23:06:06 WARN  discord-gateway.c:358: [DISCORD_GATEWAY] CLOSE DISCORD_GATEWAY_CLOSE_REASON_INVALID_INTENTS (code: 4013, 18 bytes): 'Invalid intent(s).'
23:06:06 WARN  discord-gateway.c:394: [DISCORD_GATEWAY] Gateway will not attempt to reconnect
23:06:06 WARN  discord-gateway.c:792: [DISCORD_GATEWAY] Discord Gateway Shutdown

@lcsmuller
Copy link
Collaborator Author

lcsmuller commented Jun 2, 2023

Yeah then forget about that trick.. I assumed just filling up all uint64_t bits with 1 would work. Concord automatically sets the intent for you based on the events you want to listen to, but in case you still want to set the intents manually you can use an Intents Calculator and then enter that value to discord_add_intents().

@Macintosh-Fan
Copy link

Yeah then forget about that trick.. I assumed just filling up all uint64_t bits with 1 would work. Concord automatically sets the intent for you based on the events you want to listen to, but in case you still want to set the intents manually you can use an Intents Calculator and then enter that value to discord_add_intents().

That seems to work; thank you. I also just found the Discord server link lol to ask there in the future.

@ThePedroo ThePedroo unpinned this issue Jun 12, 2023
@lcsmuller lcsmuller pinned this issue Aug 1, 2023
lcsmuller pushed a commit to ThePedroo/concord that referenced this issue Dec 7, 2024
Adding slash commands guide, that will teach how to create (global and guild specific) slash commands, respond to them, and how delete them.

References Cogmasters#109
lcsmuller pushed a commit that referenced this issue Dec 7, 2024
Adding slash commands guide, that will teach how to create (global and guild specific) slash commands, respond to them, and how delete them.

References #109
@lcsmuller
Copy link
Collaborator Author

Oops, wrong PR, I meant to close #160

@lcsmuller lcsmuller reopened this Dec 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

3 participants