I would like to suggest the creation of an official Flarum Wiki. I'm not talking here about a Flarum extension or feature, but a proper wiki on the official website that goes alongside the docs and discuss (this forum).
A wiki would be a great complement to the official docs and discussions in this forum and would resolve some of the difficulties we encounter when looking for information/help/solutions.
The docs are good and necessary, but they don't cover everything (they of course can't cover everything) :
- they cover only general and most common (and recommended) installs and configurations
- they don't cover extensions
- they're not always up to date do to a small team with other priorities (and proposing an update or correcting a page is tedious for any external contributor : clone repo, commit, pr etc.)
The discuss forum is also great and necessary for the obvious reasons (engagement, community, a kind of demo of a flarum implementation, support, resources, showcases, dev updates, etc.) but it has it limitations:
- as the community grows, a lot of the useful information gets lost in the mass of messages, whether they're fixes, good practices, workarounds, patchs, extension updates & changelogs, user feedback, etc.
- Even in a single discussion (i.e. an extension discussion) sometimes is very difficult to find an info or to stay with the extension info, sometime it's scattered in different discussions and different tags
- the search feature isn't always a good solution/help (a an issue could be described in different terms/wording)
don't want to make it too long but I think a Wiki would help (alot) with that and offer other benefits:
- a Wiki would be another tool for community growth and engagement
- a Wiki (as docs do) would offer a better
structuredplace to find useful information and add what docs can't : extensions docs and tricks from the community.
- a wiki can extend the official docs to help with special usages and cases
- a wiki would help organize and share dev tips and best practices that would be easily found and updated (for example instead of always looking into other extensions' code, the wiki could have the most useful scripts or bits to re-use when building our own, all in one place and gain a lot of dev time)
- a wiki also would help share and organize the best local extenders
A wiki will not replace discuss (which would still remain the place to ask questions, find support and a share fixes and solutions and suggestion...) but I see it as a (necessary) extension of the existent.
I know I could go and launch a wiki somewhere else and share the link here, but I think the best way to go about it is for it to be integrated to the official site (and maybe have it share the same user accounts as discuss).
