The FAQ is not a FAQ

Site Experience
,
1

The FAQ isn’t, resulting in disappointment for folks hoping to learn the well-known and avoid asking the well-answered, and putting the guidelines for the platform somewhere folks won’t look.

1 Like
2

Hi @AJCxZ0!

First of all, thanks for the feedback! We truly appreciate it! :raising_hands: Could you elaborate on what you would like to ideally see in the FAQ and whether you think there would be a better place for the guidelines to live in?

1 Like
3

The original and still best use of a Frequently Asked/Answered Questions document is a collection of actual frequently asked and answered questions, with the goal of saving folks from both asking and answering the same questions. More commonly, it’s misused as the name of a document which some provider wants users to read to learn specific information.

Nginx and the community (including the Community) have been around for so long that there are many well-known frequently asked and answered questions. Collecting these, editing them for correctness, clarity, brevity, and consistency with links to relevant resources should be an ongoing process in an evolving document.
I suggest starting small, even if only one question; just be sure it’s a question that people actually ask here, not something like “Why is Nginx the best web server ever?” (though some variation of that question may be a FAQ). Focus on new users’ first few posts, as they are your target audience.

Guidelines deserve their own place alongside the FAQ. One guideline would of course be to read the FAQ and not ask or answer questions which are adequately covered in it.
The tricky job is to clearly delineate Guidelines (i.e. behavioural norms) from Rules (i.e. the laws of the service) and Terms & Conditions (i.e. what the lawyers need said).

1 Like
4

Thanks for the extra info! It’s a little bit tricky because there is “technically” already a FAQ in the nginx.org site here https://nginx.org/en/docs/faq.html. It is quite barebones, true, but ideally we would only have a single FAQ overall. That being said, we will look into it and try to come up with a better solution overall! :smiley:

1 Like
5

Thank you for the clear and detailed feedback, @AJCxZ0 – we truly appreciate it. We want this forum to be a useful resource for people and input like this helps improve everyone’s experience.

I’ve updated the FAQ button to redirect to the existing FAQ page on nginx.org as a starting point.

1 Like