Fossil SCM
forum.wiki updates.
Commit
dd8beced5a149136f57277cc9360af8a177535ae2cee7eab153907da809cea94
Parent
e2bb38a4636865b…
1 file changed
+16
-9
+16
-9
| --- www/forum.wiki | ||
| +++ www/forum.wiki | ||
| @@ -411,11 +411,11 @@ | ||
| 411 | 411 | further responses. |
| 412 | 412 | |
| 413 | 413 | <h2 name="status">Setting Post Statuses</h2> |
| 414 | 414 | |
| 415 | 415 | The setting <tt>forum-statuses</tt> controls whether this feature is |
| 416 | -is abled. If it is not set, is not valid JSON5, or has only a single | |
| 416 | +is enabled. If it is not set, is not valid JSON5, or has only a single | |
| 417 | 417 | entry, then status are not shown in the forum. |
| 418 | 418 | |
| 419 | 419 | <tt>forum-statuses</tt> is a JSON5-format array of objects in the |
| 420 | 420 | following format: |
| 421 | 421 | |
| @@ -426,29 +426,36 @@ | ||
| 426 | 426 | ... |
| 427 | 427 | ]</verbatim> |
| 428 | 428 | |
| 429 | 429 | The list defines the legal statuses for forum posts and syncs with |
| 430 | 430 | other project-level settings. All "label" and "value" members must be |
| 431 | -unique. | |
| 431 | +unique within the scope of that list. | |
| 432 | 432 | |
| 433 | 433 | If the list has two or more entries then the forum behavior changes in |
| 434 | 434 | the following ways: |
| 435 | 435 | |
| 436 | 436 | * The root of each thread, when selected, gets a new UI control for |
| 437 | 437 | displaying or editing the status, depending on permissions. |
| 438 | 438 | * The forum list shows the "label" value of the current status. |
| 439 | 439 | |
| 440 | -This is managed via a <tt>status</tt> tag on the first version of | |
| 441 | -that post. That tag may be set to any value from the "values" members | |
| 442 | -of the <tt>forum-statuses</tt> list. | |
| 440 | +A list with only a single entry is treated as empty, the justification | |
| 441 | +being that if there is only one option then the UI does not need to be | |
| 442 | +cluttered with it. | |
| 443 | + | |
| 444 | +This setting is applied via a <tt>status</tt> tag on the first version | |
| 445 | +of a legal post. That tag may be set to any value from the "values" | |
| 446 | +members of the <tt>forum-statuses</tt> list. | |
| 443 | 447 | |
| 444 | 448 | Status tag rules: |
| 445 | 449 | |
| 446 | 450 | * <tt>status</tt> is only observed on the root of each thread. The UI |
| 447 | 451 | does nothing with that tag on responses. |
| 452 | + * The first list entry is considered to be the default status. Any post | |
| 453 | + which has no <tt>status</tt> tag, or has a <tt>status</tt> tag value | |
| 454 | + which is not in that list, is assumed for most purposes to have the | |
| 455 | + value of the first entry in the list. | |
| 448 | 456 | * The tag is applied only to the first version of any given post. The |
| 449 | 457 | UI ensures that the tag is applied to the proper post, even when |
| 450 | 458 | it is rendering a newer version. |
| 451 | - * The first list entry is considered to be the default status. Any post | |
| 452 | - which has a <tt>status</tt> tag value which is not in the | |
| 453 | - list, or which has no <tt>status</tt> tag, is assumed for most | |
| 454 | - purposes to have the value of the first entry in the list. | |
| 459 | + | |
| 460 | +The UI will eventually offer the ability to filter the post list by | |
| 461 | +status. | |
| 455 | 462 |
| --- www/forum.wiki | |
| +++ www/forum.wiki | |
| @@ -411,11 +411,11 @@ | |
| 411 | further responses. |
| 412 | |
| 413 | <h2 name="status">Setting Post Statuses</h2> |
| 414 | |
| 415 | The setting <tt>forum-statuses</tt> controls whether this feature is |
| 416 | is abled. If it is not set, is not valid JSON5, or has only a single |
| 417 | entry, then status are not shown in the forum. |
| 418 | |
| 419 | <tt>forum-statuses</tt> is a JSON5-format array of objects in the |
| 420 | following format: |
| 421 | |
| @@ -426,29 +426,36 @@ | |
| 426 | ... |
| 427 | ]</verbatim> |
| 428 | |
| 429 | The list defines the legal statuses for forum posts and syncs with |
| 430 | other project-level settings. All "label" and "value" members must be |
| 431 | unique. |
| 432 | |
| 433 | If the list has two or more entries then the forum behavior changes in |
| 434 | the following ways: |
| 435 | |
| 436 | * The root of each thread, when selected, gets a new UI control for |
| 437 | displaying or editing the status, depending on permissions. |
| 438 | * The forum list shows the "label" value of the current status. |
| 439 | |
| 440 | This is managed via a <tt>status</tt> tag on the first version of |
| 441 | that post. That tag may be set to any value from the "values" members |
| 442 | of the <tt>forum-statuses</tt> list. |
| 443 | |
| 444 | Status tag rules: |
| 445 | |
| 446 | * <tt>status</tt> is only observed on the root of each thread. The UI |
| 447 | does nothing with that tag on responses. |
| 448 | * The tag is applied only to the first version of any given post. The |
| 449 | UI ensures that the tag is applied to the proper post, even when |
| 450 | it is rendering a newer version. |
| 451 | * The first list entry is considered to be the default status. Any post |
| 452 | which has a <tt>status</tt> tag value which is not in the |
| 453 | list, or which has no <tt>status</tt> tag, is assumed for most |
| 454 | purposes to have the value of the first entry in the list. |
| 455 |
| --- www/forum.wiki | |
| +++ www/forum.wiki | |
| @@ -411,11 +411,11 @@ | |
| 411 | further responses. |
| 412 | |
| 413 | <h2 name="status">Setting Post Statuses</h2> |
| 414 | |
| 415 | The setting <tt>forum-statuses</tt> controls whether this feature is |
| 416 | is enabled. If it is not set, is not valid JSON5, or has only a single |
| 417 | entry, then status are not shown in the forum. |
| 418 | |
| 419 | <tt>forum-statuses</tt> is a JSON5-format array of objects in the |
| 420 | following format: |
| 421 | |
| @@ -426,29 +426,36 @@ | |
| 426 | ... |
| 427 | ]</verbatim> |
| 428 | |
| 429 | The list defines the legal statuses for forum posts and syncs with |
| 430 | other project-level settings. All "label" and "value" members must be |
| 431 | unique within the scope of that list. |
| 432 | |
| 433 | If the list has two or more entries then the forum behavior changes in |
| 434 | the following ways: |
| 435 | |
| 436 | * The root of each thread, when selected, gets a new UI control for |
| 437 | displaying or editing the status, depending on permissions. |
| 438 | * The forum list shows the "label" value of the current status. |
| 439 | |
| 440 | A list with only a single entry is treated as empty, the justification |
| 441 | being that if there is only one option then the UI does not need to be |
| 442 | cluttered with it. |
| 443 | |
| 444 | This setting is applied via a <tt>status</tt> tag on the first version |
| 445 | of a legal post. That tag may be set to any value from the "values" |
| 446 | members of the <tt>forum-statuses</tt> list. |
| 447 | |
| 448 | Status tag rules: |
| 449 | |
| 450 | * <tt>status</tt> is only observed on the root of each thread. The UI |
| 451 | does nothing with that tag on responses. |
| 452 | * The first list entry is considered to be the default status. Any post |
| 453 | which has no <tt>status</tt> tag, or has a <tt>status</tt> tag value |
| 454 | which is not in that list, is assumed for most purposes to have the |
| 455 | value of the first entry in the list. |
| 456 | * The tag is applied only to the first version of any given post. The |
| 457 | UI ensures that the tag is applied to the proper post, even when |
| 458 | it is rendering a newer version. |
| 459 | |
| 460 | The UI will eventually offer the ability to filter the post list by |
| 461 | status. |
| 462 |