• This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn more.

Request: Allow documentation requests in Suggestions subforum


Well-known member

I would like to request that threads for documentation requests be allowed in the suggestions subforum.

If documentation requests were allowed in the suggestions subforum, then the XenForo team would be able to get a clearer sense of how the community feels about it. When the developers sort the threads in that subforum by first post likes, they will see documentation requests on a level playing field with other requests. For example, many packages provide official developer documentation, but XenForo does not (I'm not referring to PHPDoc, which is not a good way to funnel smart admins into becoming developers). If documentation requests were allowed in the Suggestions subforum, then developers could get a clearer sense of how important the community considers development documentation to be.

Many of the features I would most want XF to be spending its limited resources on have to do with documentation. Xenforo is a feature rich application and many of the features it doesn't already have either can be provided by addons or would take an exorbitant amount of developer time to add. Providing good documentation is relatively cheap and should be appropriately prioritized.

In my experience, good documentation is a core part of user experience. It will never be as exciting as new features, but for a large portion of users, it is a key influencer of how they feel about the product. Forum threads are great, but they are incomplete, unsystematic and often incorrect, which can breed frustration. A forum can't substitute for a well-written and systematic manual.

Right now it isn't worth making suggestions about documentation because any thread will fade into oblivion fairly rapidly. For example, consider the following thread:
That's frustrating!

Thanks for taking the time to read. If you don't like the request, I hope you will give your reasons why, so I may better understand them.


XenForo moderator
Staff member
The suggestions forum is for features and functionality of the software.

A thread suggesting documentation wouldn't fit there.

Regardless of the visibility of any threads about it, we are aware of the requests.