Editing Help:Structured Discussions

{{:Help:Contents}}
Most [[Help:Talk pages|talk pages]] at Wiki Law School comprise '''Structured Discussions'''. A Structured Discussion is an aggregation of multiple ''Topics'', where each topic is independent and can be [[Help:Watchlist|watched]]] separately. In other words, a user can choose which topics within a talk page they want to watch; not a whole page as most other items on the watchlist are.

When new topics are created, they are added at the top of the talk page. However, topics can be sorted by time of creation or time of last activity.

== Interface == 

A simplified layout of a Structured Discussions board is shown below. (Some specific elements around messages are not shown, such as signatures, reply links, tools, etc.)

[[File:Structured Discussions example.png]]

== How to use Structured Discussions ==
{{anchor|basics}}
=== Editing basics ===
[[File:Flow toolbar.png|thumb|542x542px|Structured Discussions toolbar, with buttons to style, links, mention and, on the right, switch to a different editor (wikitext or visual).]]

You can participate in discussions by using two input systems: the visual editor (by default) and the wikitext editor. You can switch anytime between visual editing mode and wikitext editing mode.

When you post an answer or create a new topic, you will have a toolbar with 4 buttons:
* 3 buttons on the left:
** add style
** add link (with suggestions and search)
** mention someone (with suggestions and search)
* one button on the right to switch between editors.

{{anchor|post}}
=== Post an answer === 

==== To the global topic ====

Each participant posts below the discussion, in a chronological way. Your ''Post'' will be displayed below all previous comments in that topic. If you need to say something special to someone, you can mention the user or reply to them (see below).

The "reply" button is used in this case, to create a digression. That digression creates an indentation. It is possible to add 7 levels of digressions.

Your ''Post'' will be displayed below the comment you reply to, with an indentation if it is not the last one on the ''Board''.

You can also just thank someone for their post by clicking <code>Thank</code>.

==== To a specific person in a topic ====

If you want to say something to someone in particular, you can mention that person on your global answer, or click on the "''Reply''" button below the post. Clicking on  "''Reply''" will add a ''Post'' below the ''Post'' you want to answer directly, except if that post is the last of all discussions. For that last case, we assume that the reply is to the global topic and the reply will directly be below the last one.

To provide a better context in your reply, you can also quote someone's message by copy-pasting part of it.

Your ''Post'' depends on the ''Post'' you reply on. This ''Post'' is designed as a specific answer. It will be separated from the main discussion by a grey line. However, every person who watches this ''Topic'' will get a notification of your answer, like all answers.

{{anchor|create}}
=== Create a discussion === 
[[File:New discussion in Flow.png|thumb|534x534px|How to create a discussion: click on the "Start a new topic" bar.]]

On a page using Structured Discussions, creating a new topic is easy: you just need to click on the "Start a new topic" field. Structured Discussions will prepare two fields.

The first field is "start a new topic", choose a relevant title. In the second field, which says "Post a new message...", add your text. Choose your title wisely if you want to attract readers: people will see it on their Notifications without other details.

When you are ready, click on the "Add topic" button. Your ''Post'' will then be online and every person watching the page will be notified of the creation of this new topic.

You will be auto-subscribed when you create a topic: you will get a notification when someone replies.

{{anchor|watch}}
=== Watching ===
==== A topic ====

To watch a specific subject, click on the star on the top of the ''Topic'', near of the title. It turns blue. If it is already blue, you already were watching this topic.

While watching, you will get a notification for every edit to this ''Topic''. You will also get a watch list entry.

When you create a ''Topic'', you are auto-subscribed to this ''Topic.''

==== A Talk page ====

To watch a whole talk page, click the star icon [[File:Timeless Skin - Star.png|20px]] near the top of the page. Once that page is on you watch list, it becomes a filled-in star [[File:Timeless Skin - Star-filled.png|20px]].

While watching, you will receive a notification for any changes of the board description and every new subject posted on this talk page.

{{anchor|notifications}}
==== Notifications ====

You can turn off Structured Discussions notifications in your [[Special:Preferences#mw-prefsection-echo|notifications preferences]]. Your watchlist will be still updated with a new line for every subject on a talk page you watch or a new line when someone answers a Topic you watch.

{{anchor|browse}}
== Browse and archive ==
All Topics displayed on a board are listed on a table of contents. You can browse all these Topics on this table.

Archiving is automated: all discussions disappear when they are not active anymore. You can display older Topics by scrolling down the page, or by searching on the table of contents.
[[Category:Help|Structured Discussions]]