Explain tags and such in the FAQ

RedEnchilada · Mar 11, 2014 · 11ce47a · 11ce47a
1 parent 2b1fb88
commit 11ce47a
Show file tree

Hide file tree

Showing 2 changed files with 39 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
 rainbowdash-network
 ===================
 
-Repository for the source code of Rainbow Dash Network, a StatusNet instance for bronies.
+Repository for the source code of Rainbow Dash Network, a StatusNet instance for anyone but bronies.
diff --git a/doc-src/faq b/doc-src/faq
@@ -48,6 +48,9 @@ Drops down to a list of everything you follow: groups, lists, searches, and tags
 <span style="font-family: FontAwesome;font-size: 16px">&#xf112;</span> **Replies**  
 A list of replies by other users made to notices you've posted. Handy for keeping up with responses if your personal timeline is busy.
 
+<span style="font-family: FontAwesome;font-size: 16px">&#xf004;</span> **Favorites**  
+A list of notices you have favorited.
+
 <span style="font-family: FontAwesome;font-size: 16px">&#xf0e0;</span> **Private inbox**  
 Your inbox, where you can receive and send private messages with people you have mutually subscribed to, as well as site staff.
 
@@ -57,7 +60,41 @@ Allows you to adjust various settings that affect how you use the site. This is
 <span style="font-family: FontAwesome;font-size: 16px">&#xf011;</span> **Logout**  
 Logs you out of the site.
 
-### I don't like this whole "threaded replies" thing. How do I change it? ###
+### What are these @, #, !, @# things? ###
+
+Those represent the various methods of interacting through notices on the site. Use each one by typing it as you see it elsewhere. 
+There is no hard limit on how many of each of these may be used in a single notice.
+
+**@mentions**  
+References another user on the site. Often seen at the front of a notice when replying to another user. (When creating replies, it is 
+recommended to use the Reply button by each notice instead of manually inputting a username.) Notices containing a mention show up in the 
+referenced user's Replies page. Clicking on one will open the referenced user's profile.
+
+**#tags**  
+Often used as a method of categorization or description of a notice. These are used to link together notices with common topics, or 
+in some cases as a warning (such as the #<span style="color: red">NSFW</span> tag). Clicking on one will open a page containing other 
+notices with the same tag.
+
+**!groups**  
+A more structured method of categorization than tags. Groups require the user to be a member before posts can be sent to one. In addition, 
+posts sent to groups can be marked as "private", meaning they are only visible to other members of any group tagged in the notice. 
+Notices containing a group tag show up in the referenced group's timeline. (Note that they also show up on all other timelines where 
+such a notice would otherwise show up, including the public timeline.) Notices from all groups you are a member of will show up in your 
+Personal timeline. Clicking on a group tag will open the referenced group's page.
+
+Note that as of December 2013, the preferred method of posting to a group is to use the "To:" dropdown selector to select the group 
+to post to. This is the only way to post a private notice to a non-private group. Use of group tags is still supported, however, and 
+is currently the only method of posting a notice to more than one group, or "grandfathering" a conversation into a group by tagging 
+it in a reply.
+
+**@#lists**  
+References multiple users on the site. Lists are created by tagging other users on their profile pages (tags they've added themselves are 
+not considered; tagging yourself is a method of adding yourself to one of your own lists, among other things). It is possible to subscribe 
+to another user's list, which will cause posts from all users listed to appear on your Personal timeline. Notices containing a list tag 
+appear in the Replies timelines of every user in the list. Clicking on a list tag will open the list's timeline, showing notices from 
+all users in the list.
+
+### I prefer posts in a more linear, Twitter-esque format. How do I change it? ###
 
 If you'd like notices to be displayed in a more linear fashion (where replies show up as their own posts, rather than being attached to the original posts), 
 the [Old-school settings page](%%action.oldschoolsettings%%) allows you to toggle that behavior. You can also switch conversation pages from a