FAQ rework, replacing outdated info, better interaction FAQ (#2106)

* FAQ rework, replacing outdated info, better interaction faq

* Update docs/faq/basics/getting-started.md

Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com>

* Update docs/faq/basics/getting-started.md

Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com>

* Update docs/faq/int_framework/general.md

Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com>

* fix TOC reference

Co-authored-by: Jared L <48422312+lhjt@users.noreply.github.com>
Co-authored-by: Quin Lynch <lynchquin@gmail.com>
This commit is contained in:
Armano den Boef
2022-03-02 21:24:34 +01:00
committed by GitHub
parent b7f6db96ef
commit a13dce2550
20 changed files with 178 additions and 96 deletions

View File

@@ -8,15 +8,32 @@ title: Questions about Legacy Versions
This section refers to legacy library-related questions that do not
apply to the latest or recent version of the Discord.Net library.
## Migrating your commands to application commands.
The new interaction service was designed to act like the previous service for text-based commands.
Your pre-existing code will continue to work, but you will need to migrate your modules and response functions to use the new
interaction service methods. Documentation on this can be found in the [Guides](xref:Guides.IntFw.Intro).
## Gateway event parameters changed, why?
With 3.0, a higher focus on [Cacheable]'s was introduced.
[Cacheable]'s get an entity from cache, rather than making an API call to retrieve it's data.
The entity can be retrieved from cache by calling `GetOrDownloadAsync()` on the [Cacheable] type.
> [!NOTE]
> GetOrDownloadAsync will download the entity if its not available directly from the cache.
[Cacheable]: xref:Discord.Cacheable
## X, Y, Z does not work! It doesn't return a valid value anymore.
If you are currently using an older version of the stable branch,
please upgrade to the latest pre-release version to ensure maximum
please upgrade to the latest release version to ensure maximum
compatibility. Several features may be broken in older
versions and will likely not be fixed in the version branch due to
their breaking nature.
Visit the repo's [release tag] to see the latest public pre-release.
Visit the repo's [release tag] to see the latest public release.
[release tag]: https://github.com/discord-net/Discord.Net/releases