Forum User's FAQ (Test Mode)

Hey all,

one question bothers me : What is if two users do edit the same posting at the same time? I know that mediawiki software is very, very smart with this. But unlike discourse.org, it is only a software, not a hoster.

Hey Andy @AndyP,

Technically, you structure it using this heading syntax:

# Heading 1
Text
## Heading 2
Text
### Heading 3
Text
#### Heading 4
Text
##### Heading 5
Text
###### Heading 6

This lets it look like this:

Heading 1

Text

Heading 2

Text

Heading 3

Text

Heading 4

Text

Heading 5

Text

Heading 6

Under a heading, you could use list items or bullets

  1. Question
    Answer…
  2. Question
    Answer…
  3. (=List item)
    Answer…

or bullets:

  • Question
    Answer…
  • Question
    Answer…
  • (List item)
    Text…

Sometimes a warning may be necessary:

:warning: (Some kind of warning)
:triangular_flag_on_post: (mark)
:wrench: (TODO: Make this better)
:building_construction: (under construction: someone is working at this topic)

Or sometimes some portion of code:

Source code {
    preformatted text
}

In question of contents, since you had the idea, I hoped you already had some thoughts on structure! I suggest that you please, create your own new Test wiki (using “+New Topic” on the Main Page, and then choose the Category you want), make it a wiki, and lead the discussion?

1 Like

…I also can imagine that the collection of frequently upcoming topics/questions should be splitted on multiple wiki posts instead of a huge one.

1 Like

I am in a similar situation where I am happy to support and contribute when time permits, but can’t take the lead on this project or its ongoing maintenance.
To help me understand it’s function, perhaps an example would help me.
I try to help new users solve problems, by doing a quick forum key-word search, then providing them a link to a thread, post, video link, etc.
One that comes up from time to time is the loose white plastic wiper.
So how do we make the solution easy to find using the new wiki format?

Trouble shooting
White plastic wiper
What do I do if my white plastic wiper is loose?
(… listing of links etc from 1F support or forum members that shared a solution…)

Will it searchable using the forum search function? Careful word choice of topics and headings may become an important step as well.
These are just a few thoughts that come to mind at this early hour

Hi @TMToronto. I did a quick search test. We can filter searches for “in wiki” to narrow them down to wiki entries. I had the same concern, and I think this addresses that concern. (See below search for “red giants”

.

Concerning administration: people rarely have time to admin a site (…and not be paid for it :smile:). The onefinity forum already has some great content in the posts that if turned into a wiki and tweaked from time to time as people get ideas for refinements/updates that be great and lowish maintenance.

You have, @cyberreefguru, @blaghislain, and many others have posted some great wiki-like content that be great to surface above the froth of daily forum post

1 Like

Hey Tom, hey @AndyP, hey all,

Yes, I think this is very, very important. If you Andy are capturing possible entries, what if you looked at every incoming post, or after an issue is solved, you just try to decide about the category and subcategory this post would belong to. I do not mean capturing all these, but just having a thought on where they would belong to, and then add a subcategory to a draft of categories with a tree structure. This way we could gain a hierarchy tree for the topics.

Yes, that’s what we always do, and the FAQ would try to do this automatically.

I find it is very important to achieve a high density of hyperinformation and of further reading inside every answer.

I would suggest a bunch of criteria that would ensure a high quality:

  1. General validity: An answer should contain information that is generally applicable.
  2. Density: An answer shouldn’t be longer than necessary and should contain dense information.
  3. Good readability: An answer should use simple language that is easy to follow.
  4. Neutrality: If there is any controversy on answers, it should be integrated.
  5. Every technical term should be a link to the explanation of what it is.
    E.g. Drag chain, End mill, VFD, Universal Motor, carbon-brush commutator, Asynchronous Motor, …
  6. Every acronym and every abbreviation should be a link to its explanation.
    E.g. SSR, RCD, …
  7. Every fact should contain a link to a reference, or to a further reading.
    E.g. If you don’t like touch screens, you can connect a mouse to your Onefinity Controller.
  8. Within the text of an answer, there should be links like “as is explained here
  9. Every answer could contain a list of links to topics where the issue has been discussed here very deeply or with much information.
    E.g.
    Spindle information
    Air cooled spindle?
    Router vs spindle
1 Like