Skip to content

Restructuring and adding to the FAQ pages, some related "Getting Started" related work on the FrontPage #835

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

Merged
merged 19 commits into from
Aug 1, 2025

Conversation

playmer
Copy link
Contributor

@playmer playmer commented Jul 31, 2025

As discussed with Slouken, here's a first pass on adding the content we've been working on in the discord FAQ to the Wiki, as well as restructuring the FrontPage and the FAQ pages to funnel new developers towards the most relevant resources first.

Totally open to changing things, but I wanted to try to organize things a bit more towards the "new developer" experience, Have a section with a straight list of the things that would be most helpful, have the FAQ directly lead to developer questions, rather than a landing page, and instead have the developer questions page act as that landing page for the other FAQs.

@slouken slouken requested a review from icculus July 31, 2025 14:09
playmer and others added 11 commits July 31, 2025 10:45
For some reason whenever this comes up my mind goes to EventFilters instead of EventWatch, sorry about that.

Co-authored-by: Sam Lantinga <[email protected]>
playmer and others added 2 commits July 31, 2025 11:02
@slouken
Copy link
Contributor

slouken commented Aug 1, 2025

@icculus, this looks good to me, what do you think?

@icculus
Copy link
Contributor

icculus commented Aug 1, 2025

Yeah, this is solid gold, I'm merging it.

@icculus icculus merged commit fe9595e into libsdl-org:main Aug 1, 2025
1 check passed
@slouken
Copy link
Contributor

slouken commented Aug 1, 2025

Great, thanks @playmer, feel free to submit additional updates anytime!

@slouken
Copy link
Contributor

slouken commented Aug 1, 2025

The table on the FAQ page doesn't render properly:

Check these out if your questions aren't directly about using the library as a developer. | | | | ----------------------------- | --------------------------------------------| | [General](https://wiki.libsdl.org/SDL3/FAQGeneral) | General questions about SDL | | [Using SDL](https://wiki.libsdl.org/SDL3/FAQUsingSDL) | Questions for people using SDL applications | | [Licensing](https://wiki.libsdl.org/SDL3/FAQLicensing) | Questions about licensing SDL with products |

@playmer
Copy link
Contributor Author

playmer commented Aug 1, 2025

Hmm it was working in my local previewer. Apologies, I didn't know how to actually generate and host it locally. Let me see if I can figure out what I did wrong there before I have to head out to lunch.

@playmer
Copy link
Contributor Author

playmer commented Aug 1, 2025

Ah, markdown can be a bit finicky, seems I need a blank line between text and a table. Should be fixed, also fixed the communities link, there was a typo that broke it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants