Flarum: search within a discussion

grahamperrin

Please focus on search within a discussion.

vimanuelt

grahamperrin
I was illustrating that relying on search for impermanent or uncurated information isn’t particularly effective. It risks recreating the same fragmented and unreliable experience commonly associated with wikis. What we have now is quite nice. Let conversations be conversations and time limited. :-)

vimanuelt

Please submit a feature request. Eric can assign it to the Documentation Management board. :-) Thanks in advance.

grahamperrin

vimanuelt Documentation Management

Flarum is for forums. Not documentation.

grahamperrin

vimanuelt time limited. :-)

:-( I think you mentioned that elsewhere.

A firm "no".

vimanuelt

Forums are intended for discussion, not for long-term documentation. I believe you now see my point regarding their impermanent nature. Forums should not serve as a permanent source of truth. However, they can play a valuable role within the broader documentation model I previously proposed. Productive discussions often lead to actionable insights or resolutions, which should then be captured in the official documentation or formalised as GitHub issues or requests.

For reference: Proposal for a Consolidated Support and Documentation Model

4. Interlinking Strategy

Forum threads that expose systemic issues → turned into GitHub issues
GitHub resolutions or feature completions → summarized and linked in forum and docs
Forums can include pinned posts linking to documentation and how to file issues
Docs link only to homepage, keeping footers decluttered as per Graham’s point

5. Community Workflow Summary (Realistic)

User has problem
    ↓
Checks ReadTheDocs or search on forums
    ↓
If unclear, posts question on forums
    ↓
If bug confirmed, developer or moderator creates GitHub issue
    ↓
Fix issued → Summary added in forums → Docs updated if necessary

Trimming the Forums has merits too: https://forums.ghostbsd.org/d/353-flarum-improving-the-forums-through-pruning

brianthehughes

I like the proposed community workflow.

Getting user Q&A interactions to reference a doc and/or development reference (issue, feature, etc) or create the absent doc / dev item would certainly help interactions trend toward documentation addressing everything but edge cases and new/emerging development.

ericbsd

grahamperrin It is outdated and not maintained.

grahamperrin

ericbsd thanks, is there an alternative?

The inability to find – with Control-F – is very frustrating, in a long topic. The longer topics become, the greater the frustration …

vimanuelt

grahamperrin

vimanuelt

vimanuelt
Sadly, uploading SVG files is not allowed.

ericbsd

vimanuelt I will see if I can fix that.

ericbsd

@vimanuelt, try to upload an SVG file to see if you can now.

vimanuelt

Here is the table in SVG format.

vimanuelt

When SVG support is enabled, you should see the table above.

ericbsd

Yeah, the image format was not set properly, so the upload might have failed.

vimanuelt

The error message reads, "Uploading files of this type is not allowed."

ericbsd

Same there I made a post here https://discuss.flarum.org/d/4154-friendsofflarum-upload-the-intelligent-file-attachment-extension/2552