| | @@ -446,11 +446,11 @@ |
| 446 | 446 | which the attachment is connected. The third argument is either |
| 447 | 447 | missing or else it is the lower-case artifact ID of the attachment |
| 448 | 448 | itself. A missing third argument means that the attachment should be |
| 449 | 449 | deleted. If <i>source</i> is a forum post, the hash provided should |
| 450 | 450 | generally be the hash of the first version of the post for reasons |
| 451 | | -[#forumpost-tag|explained below]. |
| 451 | +[#forumpost-tag|explained in the section on tags]. |
| 452 | 452 | |
| 453 | 453 | The <b>C</b> card is an optional comment describing what the attachment is about. |
| 454 | 454 | The <b>C</b> card is optional, but there can only be one. |
| 455 | 455 | |
| 456 | 456 | A single <b>D</b> card is required to give the date and time when the attachment |
| | @@ -606,21 +606,24 @@ |
| 606 | 606 | [#wikichng | wiki artifact]. |
| 607 | 607 | |
| 608 | 608 | The <b>Z</b> card is the required checksum over the rest of the artifact. |
| 609 | 609 | |
| 610 | 610 | <a name="forumpost-tag"></a> |
| 611 | | -<strong>Forum posts and tags:</strong> |
| 612 | | - |
| 613 | | -When adding [#ctrl|tags] or [#attachment|attachments] to forum posts |
| 614 | | -it is generally up to the application to tag/attach to only the first |
| 615 | | -version of any given post. For example, if post X has two edits, a tag |
| 616 | | -or applied, or attachment added, by the user to post X+2 should |
| 617 | | -generally be applied to version X instead. Though this complicates the |
| 618 | | -app logic for applying tags, it simplifies the app's location of tags. |
| 619 | | -As of this writing (May 2026), no current Fossil use cases would be |
| 620 | | -improved by tagging specific subsequent versions of posts, e.g. our |
| 621 | | -hypothetical X+1. |
| 611 | +<h4>2.8.1 Tags and Attachments on Forum Posts</h4> |
| 612 | + |
| 613 | +When adding [#ctrl|tags] or [#attachment|attachments] to [#forum|forum |
| 614 | +posts] it is generally up to the application to tag, or attach to, |
| 615 | +only the first version of any given post. For example, if post X has |
| 616 | +two edits, a tag or applied, or attachment added, by the user to post |
| 617 | +X+2 should generally be applied to version X instead. Though this |
| 618 | +complicates the app logic for applying tags, it simplifies the app's |
| 619 | +location of tags for purposes of applying tag-/attachment-dependent |
| 620 | +logic. As of this writing (May 2026), no current Fossil use cases |
| 621 | +would be improved by tagging specific subsequent versions of posts, |
| 622 | +e.g. the hypothetical X+1. |
| 623 | + |
| 624 | +Forum posts, because they have a P-card, support propagating tags. |
| 622 | 625 | |
| 623 | 626 | |
| 624 | 627 | <h2 id="summary">3.0 Card Summary</h2> |
| 625 | 628 | |
| 626 | 629 | The following table summarizes the various kinds of cards that appear |
| 627 | 630 | |