Commit d2e93d00 authored by Deimos's avatar Deimos

Massive re-organization+update by Algernon_Asimov

parent 5ecd21ae
......@@ -22,7 +22,7 @@ If any other sites (or companies) decide to use Tildes code as a base, this lice
## Technology
From the technical side, Tildes aims to [use modern versions of simple, reliable, "boring" technology](https://docs.tildes.net/technical-goals#use-modern-versions-of-simple-reliable-boring-technology). This is especially important as an open-source project hoping for outside contributions, since it means that people can get involved much more easily.
From the technical side, Tildes aims to [use modern versions of simple, reliable, "boring" technology](https://docs.tildes.net/philosophy/site-implementation#use-modern-versions-of-simple-reliable-boring-technology). This is especially important as an open-source project hoping for outside contributions, since it means that people can get involved much more easily.
The core technologies are [Python 3.7](https://docs.python.org/3.7/) (using the [Pyramid](http://docs.pylonsproject.org/projects/pyramid/en/latest/) web framework) and [PostgreSQL 10](https://www.postgresql.org/docs/10/static/). A few other systems are used for specific needs, but overall, Tildes is structured as a fairly "old-school" server-side web application, with Python and PostgreSQL handling as much as possible.
......
Title: Commenting on Tildes
[TOC]
### Making a comment
There are two types of comment:
* Replies to a topic.
* Replies to another comment.
To reply to a topic, scroll to the bottom of the page to find the 'Post a comment' text box. This is at the bottom of the page by deliberate design: it's intended to make you read the other comments before adding your own. It reduces duplication: if other people have already said what you want to say, then you can add your vote to their comments. It increases engagement: if you see other interesting comments as you're scrolling down, you can join in the conversation.
To reply to a comment, click on the 'Reply' link just below it.
While writing your comment, you can apply formatting using a variant of Markdown: [Text Formatting](https://tildes.net/~tildes.official/wiki/instructions/text_formatting).
### Labelling comments
You can apply labels to other people's comments (but not your own). These labels affect the sorting and display of those comments.
Note that labels are only available to users with accounts more than 7 days old. You can't apply labels during your first week on Tildes.
To apply a label to a comment, click on the 'Label' link below the comment, and choose one of the 5 labels:
* Exemplary.
* Offtopic.
* Joke.
* Noise.
* Malice.
You can apply more than one of these labels to a comment (for example, you might label a comment as "joke" *and* "noise" if that's appropriate). Labels generally become active when the collective label weight of all users that applied this label exceeds 1.0. The default weight of new users is 0.5, so two users applying a label should be enough to trigger an effect.
#### "Exemplary" label
The "Exemplary" label is for recognising excellent comments, which are of high quality and which add something significant to the discussion.
You will need to type a brief note when applying an "Exemplary" label to a comment. Your note will be visible to the comment's author (but noone else). Your note can be as short as "good comment", or as long as you like. The note is anonymous: the comment author will not know who wrote it (although you can type that information in your note if you want).
After applying an "Exemplary" label to a comment, you must wait 8 hours before being able to apply another "Exemplary" label.
The "Exemplary" label is visible on comments as a cyan stripe on the left side of the post. Only the person who wrote the comment will be able to see the number of times a comment has been labelled "Exemplary" and the accompanying messages from the labellers.
Each "Exemplary" label applied to a comment increases its weighting in vote-based sorting: the amount of votes is multiplied with the total Exemplary label weight. Going with the default weight, 0.5:
* *A comment with 0 "Exemplary" labels will have its vote weight multiplied by 1 + (0 x 0.5) = 1.0. If this comment has 10 votes, its weighted vote will be 10 x 1.0 = 10 votes.*
* *A comment with 1 "Exemplary" label will have its vote weight multiplied by 1 + (1 x 0.5) = 1.5. If this comment has 10 votes, its weighted vote will be 10 x 1.5 = 15 votes.*
* *A comment with 2 "Exemplary" labels will have its vote weight multiplied by 1 + (2 x 0.5) = 2.0. If this comment has 10 votes, its weighted vote will be 10 x 2.0 = 20 votes.*
... and so on. The effect of "Exemplary" labels is cumulative: the more "Exemplary" labels a comment has, the higher its voting weight will be.
#### "Offtopic" label
The "Offtopic" label is for identifying comments which have veered away from the main subject of discussion in a thread. They might be good-quality or bad-quality comments, but they're about a different subject.
The "Offtopic" label is not visible on comments.
If the Offtopic label is active on a comment, it will cause the comment to be sorted below replies with no labels, acting as if it had -1 total votes.
#### "Joke" label
The "Joke" label is for comments which exist only to make a joke. They're not adding anything to the discussion, they're there just to deliver a punchline. The "joke" label should *not* be applied to an otherwise good comment which happens to include a minor humorous remark, only for comments where humour is the only ingredient.
The "Joke" label is not visible on comments.
If the "Joke" label is active on a comment, it decreases its weighting in the relevance sorting by a factor of 0.5: the vote weight on any comment labelled as a joke will be halved. The effect of "Joke" labels is not cumulative.
#### "Noise" label
The "Noise" label is for comments which make no difference to the discussion. These might include remarks such as "This^" or "Thanks." or "Good news!" or "This sucks."
The "Noise" label is not visible on comments.
If the Noise label is active on a comment, it will cause the comment to be sorted below replies with no and Offtopic labels, acting as if it had -2 total votes. Also, the comment will be autocollapsed, so that it is hidden (all its child comments will also be hidden). Collapsed comments can be manually expanded and viewed.
#### "Malice" label
The "Malice" label is for comments which contain negative language. This includes:
* Personal attacks on other Tilders.
* Bigoted language (such as racism, homophobia, transphobia, misogyny, religious slurs, and so on).
* Incitement to violence.
* Hate speech.
The "Malice" label is not visible on comments.
Each application of a "Malice" label on any comment will send a notification to the moderator/s, who will review the comment and take appropriate action. Currently, the only person with the ability to view Malice labels is @Deimos, the site admin.
#### References
Reference: [Comment tags now affect sorting, more changes coming](https://tildes.net/~tildes.official/6hn/comment_tags_now_affect_sorting_more_changes_coming)
Reference: [Many updates to The Feature Formerly Known as Comment Tagging](https://tildes.net/~tildes.official/6ue/many_updates_to_the_feature_formerly_known_as_comment_tagging)
Reference: [Comment labels](https://tildes.net/~tildes.official/wiki/instructions/commenting_on_tildes#labelling_comments)
Title: Development Setup
Summary: How to initially set up a development version of Tildes
[TOC]
......@@ -75,4 +74,4 @@ If you want to use the hooks, go into the `git_hooks/` directory in the base fol
### Start developing!
That's it for initial setup, you should now be able to start working on your development version. For more general information and knowledge that will be useful throughout the process, see the [Development](/development) page.
That's it for initial setup, you should now be able to start working on your development version. For more general information and knowledge that will be useful throughout the process, see the [Development](https://tildes.net/~tildes.official/wiki/instructions/development) page.
Title: Development
Summary: General info for working on a development version of Tildes
[TOC]
*Note: This page is fairly scattered overall and should be split up into multiple pages in the future. The goal is mostly to have a lot of information that developers might find useful so that they, at least, have a starting point to find out more about how something works.*
**If you haven't already, follow the instructions on [the Development Setup page](/development-setup) to get a development version running on your local machine.**
**If you haven't already, follow the instructions on [the Development Setup page](https://tildes.net/~tildes.official/wiki/instructions/development_setup) to get a development version running on your local machine.**
## Vagrant
......@@ -19,14 +18,17 @@ In general, you shouldn't need to do very much with Vagrant directly, but there
### Changing the Vagrant box's resources
This generally shouldn't be necessary, but it's possible to give the Vagrant box access to more resources by creating a file named `Customfile` in the same directory as the `Vagrantfile`. For example, to give it 4GB of memory and 2 CPUs, the file should contain:
This generally shouldn't be necessary, but it's possible to change the resources the Vagrant box has access to by editing the `Vagrantfile` in the base directory. By default, the box is set up with 4GB of RAM and 4 CPUs, but you can adjust these by editing these two lines near the bottom of the file:
```ruby
vb.memory = "4096"
vb.cpus = "4"
```
config.vm.provider "virtualbox" do |vb|
vb.memory = "4096"
vb.cpus = "2"
end
```
**Important - if you edit those lines**:
* Do not set the memory lower than `2048` (2GB). The VM will almost certainly end up swapping itself to death if it has less memory than that.
* If you change the values, run `git update-index --assume-unchanged Vagrantfile` so that git ignores those changes to the file and won't always want to commit them along with any actual updates you make to the Tildes code.
## SSHing into the VM
......@@ -170,8 +172,9 @@ Once you start making changes to the code that you want to contribute to the pro
* `mypy .` - Runs the [mypy static type checks](#type-checking-with-mypy).
* `black --check .` - Runs [the Black code-formatter](https://black.readthedocs.io/) checks (issues don't need to be fixed manually, just run `black .` to reformat your code).
* `prospector` - Runs the code style checks.
* `npm run lint` - Runs the javascript and SCSS linters.
If you use the included [Git hooks](/development-setup#set-up-git-hooks-optional-but-strongly-recommended), then the tests, mypy, and Black will automatically be run whenever you commit (and prevent you from committing if they fail), and all checks will be run before you can push your code to a remote repo.
If you use the included [Git hooks](https://tildes.net/~tildes.official/wiki/instructions/development_setup#set_up_git_hooks_optional_but_strongly_recommended), then the tests, mypy, and Black will automatically be run whenever you commit (and prevent you from committing if they fail), and all checks will be run before you can push your code to a remote repo.
## Testing
......
Title: Hierarchical Tags Short Rules
[TOC]
Here are listed condensed versions of the tagging suggestions from the [Hierarchical Tags](https://tildes.net/~tildes.official/wiki/instructions/hierarchical_tags) page. These are intended to be easy to reference and use accordingly for users/members with tag perms and so are very concise; for the full detailing of how these tags are used, their history, and other things of that nature, see again the [main page](https://tildes.net/~tildes.official/wiki/instructions/hierarchical_tags).
# Generally group-specific tags
## ~health
### `health.` and `medicine.`
* Use `health.` and `medicine.` when there are [applicable branches](https://en.wikipedia.org/wiki/Medicine#Branches) of medicine (i.e. `medicine.veterinary`) or modifiers (i.e `health.public` and `medicine.alternative`).
* `health.mental` and `mental health` are both acceptable.
## ~humanities
### `religion.`
* Religions always take the form `[religion name].[denomination]` (i.e. `judaism.orthodox`, `christianity.catholic`, `islam.sunni`).
* Languages, where needed, take the form `[language].[dialect]` (i.e. `english.british`, `english.american`, `espanol.peninsular`, `espanol.mexicano`).
## ~science
### `socialscience.`
* When posted in science, all social science related posts take `socialscience.[discipline]` tag (i.e. `socialscience.psychology`, `socialscience.sociology`,`socialscience.anthropology`).
# Non-group specific tags
## `recurring.`
* Use `recurring.` for threads on a specific, consistent interval; otherwise, just use standalone `recurring`.
## `economics.`
* Use hierarchical tags for branches and sub-branches of economics and modifiers like `policy` and `trade` (`economics.macro` for example).
* If posting in ~science use `socialscience.` as the parent tag instead of `economics.`
## `law.`
* Use subtags whenever there's a modifier, with the modifier being the subtag (`law.labor` for example).
* If a location tag is needed, tag it separately (`law.labor` and `usa` for example).
* Do not use `law.martial` for martial law or `law.enforcement` for law enforcement/policing.
## `nsfw.` and `trigger.`
* Use `trigger.` (if desired) to specify the potentially triggering content (`trigger.rape` for example).
* Use `nsfw.` in the same way as `trigger.` for actively graphic content or links which could expose people to actively graphic content.
## `hurricanes.`, `cyclones.`, `typhoons.`
* Use the relevant parent tag for the storm, with the storm name being a subtag even if it's not a formal hurricane/typhoon/cyclone (i.e. `hurricanes.patricia`, `cyclones.tracy`, and `typhoons.yutu`).
* If the storm only has a nickname or best known name, try a truncation of that name (such as `hurricanes.1938 new england`)
This diff is collapsed.
Title: Instructions
Here you will find instructions about:
* How to use Tildes
* How to set up a Tildes development environment
## How to use Tildes
Here you'll find information about how to do various things on Tildes, from posting topics to bookmarking them.
**DISCLAIMER:** These instructions are a **WORK IN PROGRESS** in two ways.
*First*, the instructions are not yet complete. They are being written progressively. Most sections are finished, but some sections are just stubs and some sections are not yet started. As time goes by, it will become more and more complete.
*Second*, Tildes is an alpha-testing website which is still under development. Features are being changed and being added. Therefore, even for the finished sections, these instructions will be current only at a point in time. Right now, that's 26th May 2019. Anything that has been changed on Tildes after this date is not yet reflected in these instructions.
* [The Tildes front page](https://tildes.net/~tildes.official/wiki/instructions/tildes_front_page)
* [Tildes groups](https://tildes.net/~tildes.official/wiki/instructions/tildes_groups)
* [Posting on Tildes](https://tildes.net/~tildes.official/wiki/instructions/posting_on_tildes)
* [Commenting on Tildes](https://tildes.net/~tildes.official/wiki/instructions/commenting_on_tildes)
* [Navigating Tildes](https://tildes.net/~tildes.official/wiki/instructions/navigating_tildes)
* [Replying and messaging](https://tildes.net/~tildes.official/wiki/instructions/replying_and_messaging)
* [User settings](https://tildes.net/~tildes.official/wiki/instructions/user_settings)
* [Mobile devices](https://tildes.net/~tildes.official/wiki/instructions/mobile_devices)
* [The Tildes wiki](https://tildes.net/~tildes.official/wiki/instructions/the_tildes_wiki)
---
## How to set up a Tildes development environment
* [Development Setup](https://tildes.net/~tildes.official/wiki/instructions/development_setup): the requirements and steps to set up your own local development version of Tildes.
* [Development](https://tildes.net/~tildes.official/wiki/instructions/development): how to work on your local development version of Tildes.
Title: Mobile Devices
**There is no Tildes mobile app**, and there is no plan to make an official app for Tildes.
To use Tildes on your tablet or smartphone, simply open your internet browser and navigate to https://tildes.net. The Tildes website will automatically adapt its display settings to fit your screen, whether large or small. Some browsers also allow you to create a shortcut on the device's home screen, which will take you directly to the website.
Reference: [The site is the main mobile interface, not an app](https://docs.tildes.net/philosophy/site-implementation#the-site-is-the-main-mobile-interface-not-an-app)
Title: Navigating Tildes
[TOC]
### Viewing links and comments
When you're viewing the front page, you can click on topics to view the linked item, or to view the comments on the topic.
To open **the linked item** in a topic (article, video, blog), click on the big bold title. Depending on your [user settings](https://tildes.net/~tildes.official/wiki/instructions/user_settings#opening_links), the linked item can open in either a new tab or the current tab.
To open **the comments** on a topic, click on the small link that says 'X comments' below the title. Depending on your [user settings](https://tildes.net/~tildes.official/wiki/instructions/user_settings#opening_links), the comments page can open in either a new tab or the current tab.
### Sorting comments
When viewing a topic page, you can sort the comments in four ways:
* **most votes** sorts the comments by the highest number of votes. Top-level comments with the most votes appear at the top of the page, and top-level comments with the fewest votes appear at the bottom of the page.
* **newest first** sorts the comments so that the most recent top-level comment is at the top of the page and the oldest top-level comment is at the bottom of the page.
* **order posted** sorts the comments so that the oldest top-level comment is at the top of the page and the most recent top-level comment is at the bottom of the page.
* **relevance** sorts the comments by the highest number of votes, including any effects from [comment labels](https://tildes.net/~tildes.official/wiki/instructions/commenting_on_tildes#labelling_comments).
### Finding new comments
There is a user setting which will allows you to highlight new comments in a thread (comments which have been posted since the last time you looked at the thread). You can find more information about that in the '[Marking new comments](https://tildes.net/~tildes.official/wiki/instructions/user_settings#marking_new_comments)' section on the User Settings page of these instructions.
### Collapsing replies
At the top of the comments on a topic page, there are two buttons:
* Collapse replies
* Expand all
If you click on "Collapse replies", all reply comments will be hidden, leaving only top-level comments visible. You can restore any old comments by clicking on the "+" button on the comment stub.
If you click on "Expand all", all comments will be restored to normal visibility.
[Added buttons to collapse all reply comments and expand all comments](https://tildes.net/~tildes.official/5c8/added_buttons_to_collapse_all_reply_comments_and_expand_all_comments)
### Comment highlights
* Blue left-hand border = Exemplary comment
* Black left-hand border = Original Poster's (OP's) comment
* Red left-hand border = New comment
* Brown left-hand border = Linked comment
### Viewing a group
To view a group on Tildes, go to the front page, and look in the sidebar for the button that says 'Browse the list of groups' (at the bottom). The 'Browse groups' page lists all groups on Tildes.
If you're already subscribed to the group, it will appear directly in the sidebar of your front page. Click on the link in the sidebar.
Title: Posting on Tildes
[TOC]
Posts on Tildes are called "topics". There are two types of topics:
* **Link topics**, which are links to an offsite article or video.
* **Text topics**, which contain text that is written and hosted on Tildes.
(Note: you can use text topics to post links, if you want to provide an introduction or some context for what you're posting. Simply include the URL in the text field as part of what you type.)
### Creating a topic
To create a topic on Tildes, you must first [navigate to the group](https://tildes.net/~tildes.official/wiki/instructions/navigating_tildes#viewing_a_group) you want to post the topic in. All topics must be posted in a group or sub-group. (It's okay if you're not sure which group to post your topic in. Just pick the group or sub-group you think is most appropriate. If there's a better place for your topic, someone else will probably come along and [move it for you](https://tildes.net/~tildes.official/wiki/instructions/posting_on_tildes#moving_topics).)
In the sidebar of the group, click on the "Post a new topic" button to create a topic. There are three fields to complete: Title, Link, and Text.
* For a **link topic**, complete the Title and Link fields. Type a title for the topic: this will usually be the title of the article or video you're posting. Paste the URL of the article or video into the Link field.
* For a **text topic**, complete the Title and Text fields. Type a title for your topic. Enter your text in the Text field. Use this option if you're asking a question, or presenting your own topic for discussion.
* If you want to post a link topic, and simultaneously post the first comment under your topic, complete all three fields: Title, Link, and Text. Type the title for the topic from the title of the article or video you're posting; paste the URL of the article or video into the Link field; type your opening comment into the Text field.
To submit your topic, click on the "Post topic" button under the entry fields.
Reference: [Daily Tildes discussion (and changelog) - "new topic" page and process updated](https://tildes.net/~tildes.official/2kh/daily_tildes_discussion_and_changelog_new_topic_page_and_process_updated)
### Tagging topics
You can apply tags to your post, which can be used by people [to filter their front page](https://tildes.net/~tildes.official/wiki/instructions/tildes_front_page#filtering_the_topics). Tags are not compulsory, but they are *extremely* useful and helpful. If you don't enter tags on your topic, someone else will probably come along and [add some for you](https://tildes.net/~tildes.official/wiki/instructions/posting_on_tildes#changing_tags)!
Tags go in the 'Tags' field.
Tags should describe what the topic is about. They can be geographic identifiers ("usa", "china", "india"), or they can indicate the subject matter ("biology", "social media", "history"), or they can indicate the type of topic ("ask", "introductions", "casual").
Tags are hierarchical: there can be sub-tags. For instance, a geographical tag can include the country *and* the state/province/county. Or a tag for the type of topic can show the sub-type as well. To include a sub-tag in a tag, use a full stop / period (".") character between the top-level tag and a sub-level tag. They can go to multiple levels.
For example:
* "canada" shows that this topic is about something in the country of Canada.
* "canada.qc" shows that this topic is about something in the province of Quebec within the country of Canada.
* "canada.qc.montreal" shows that this topic is about something in the city of Montreal in the province of Quebec within the country of Canada.
* "ask" shows that this topic is asking a question.
* "ask.recommendations" shows that this topic is asking for recommendations.
* "ask.survey" shows that this topic is asking for people's opinions ("best", "worst", "favourite").
Tags can include *only* letters, numbers, and the space character. No special characters are permitted. "smartphones" and "smart phones" are valid tags; "smart-phones" is not a valid tag.
Tags are not case sensitive: any uppercase letters you enter will be converted to lower case letters.
As you start typing a tag, you will see a list of suggested tags starting with the letter(s) you have typed. This list of suggestions is taken from the most popular tags in the group you are posting to. With each extra letter you type, the list will narrow to match your typing. For example:
* When you type "**s**", you will see a long list of tags starting with "s".
* When you type "s**o**", you will see a medium list of tags starting with "so".
* When you type "so**c**", you will see a short list of tags starting with "soc".
You can apply multiple tags to a topic: separate each tag with a comma.
Reference: [Topic tags](https://tildes.net/~tildes.official/wiki/instructions/posting_on_tildes#tagging_topics)
Reference: [Autocomplete for topic tagging is now available](https://tildes.net/~tildes.official/cpl/autocomplete_for_topic_tagging_is_now_available)
### Editing topics
Some people are able to edit topics after they are posted. This ability is not available to all people. In the long term, this ability will be earned through a proposed trust system; for now, Deimos must manually give this permission to someone.
There are three available ways to edit topics:
* Change the tags on the topic
* Edit the title of the topic
* Move the topic to a different group
All edits to a topic will be recorded in the Topic log, which is found in the sidebar of the topic. The changes made, and the user who made them, will remain visible in the log for 30 days. After 30 days, the record of changes will be removed in accord with Tildes' [privacy policy](https://docs.tildes.net/policies/privacy-policy).
#### Changing tags
To change a tag on a topic, click on the 'Tag' link below the topic's text or URL. All tags will become editable: you can remove old tags and add new tags. Refer to the [Tagging Topics section](https://tildes.net/~tildes.official/wiki/instructions/posting_on_tildes#tagging_topics) for more information.
#### Editing titles
To edit the title of a topic, click on the 'Edit title' link below the topic's text or URL. A text field will open, with the title's text. You can make any changes to this text. When you finish editing, click on the 'Update Title' button to save your changes.
#### Moving topics
To move a topic from one group to another group, click on the 'Move' link below the topic's text or URL. Type in the name of the new group or sub-group for the topic, then click on the 'Move Topic' button to save the changes.
Reference: [Users can now be (manually) granted permissions to re-tag topics, move them between groups, and edit titles](https://tildes.net/~tildes.official/53r/users_can_now_be_manually_granted_permissions_to_re_tag_topics_move_them_between_groups_and_edit)
Title: Replying and Messaging
[TOC]
### Notifying users
You can send a notification to another user and draw their attention to a comment, without replying to one of their topics or comments. To do so, type @username in the comment. /u/username and u/username will also work. This will send a notification to the other user's inbox. There is no limit on the number of users you can tag in a single comment.
**User notifications do not work in topics**, only in comments.
Reference: [Username mentions in comments now send notifications](https://tildes.net/~tildes.official/4i5/username_mentions_in_comments_now_send_notifications)
Title: Text Formatting
Summary: A reference for markdown used on Tildes
[TOC]
......@@ -133,7 +132,7 @@ Subsequent quoted paragraphs will be merged into a single blockquote, even if th
### Strikethrough
You can strike through some text by putting tildes before *and* after it.
You can strike through some text by putting two tildes before *and* after it.
```
I ~~can't find it~~ found it.
......@@ -199,6 +198,10 @@ Which renders as: [Go to Tildes!](https://tildes.net)
There are several formatting features that can, currently, only be created by writing HTML (no markdown syntax is available):
### Small text
You can write text that will be displayed in a smaller font size (which is good for uses such as "side comments") by using the `<small>` tag.
### "Inserted" text
Strikethrough text can be created with markdown, but you can also (optionally) show the text you're replacing the strikethrough text with using the `<ins>` tag, such as: `I think this starts at ~~9 PM~~ <ins>10 PM</ins>`.
......
Title: The Tildes Wiki
**Note**: This feature is currently being experimented with, and is available to users who message @Deimos
Wikis are useful for common databases of information, rules and traditions that a community might have. Unlike comments, all content in the wikis are shared under the [Creative Commons Attribution-ShareAlike 4.0](https://creativecommons.org/licenses/by-sa/4.0/) license and they have a [git history available publicly](https://gitlab.com/tildes/tildes-wiki/commits/master) (so do not post personal data because it can't be deleted!).
Currently there are quirks with the system which should be fixed in the future :
- Groups with no wikis have to be manually navigated to to create pages in them such as [https://tildes.net/~tildes.official/wiki](https://tildes.net/~tildes.official/wiki), if you have permissions, you'll have access to a button to create new pages.
- Pages can't be renamed or deleted, you'll need to [message Deimos](https://tildes.net/user/Deimos/new_message) for that.
- Permissions are global, there is no permission system per-group.
Reference: [A basic wiki system is now available for groups](https://tildes.net/~tildes.official/drm/a_basic_wiki_system_is_now_available_for_groups)
Title: Tildes Front Page
[TOC]
When you view Tildes, you'll see a front page that lists topics that have been posted in various groups.
### Sorting the topics
You can change the order in which the topics are displayed.
There are five sorting options:
* **Activity** orders the topics so that the topics with recent comments posted in them appear at the top. Some comments are excluded and will not cause the topic to "bump", such as ones made in threads labeled as Offtopic and Noise.
* **Votes** orders the topics so that the topics with the highest number of votes appear at the top.
* **Comments** orders the topics so that the topics with the highest number of comments appear at the top.
* **New** orders the topics so that the topics posted most recently appear at the top.
* **All activity** orders the topics so that the topics which have most recently had a comment posted under them appear at the top. This is similar to the "Activity" sort, but without any exclusions (so *any* comment will always cause a topic to come back to the top).
There is also a time-based filter. It shows as "from", with a selection box. This allows you to limit the topics by when they were posted:
* **last 1 hour** will limit the list to only those topics which were posted in the last 1 hour.
* **last 12 hours** will limit the list to only those topics which were posted in the last 12 hours.
* **last 24 hours** will limit the list to only those topics which were posted in the last 24 hours.
* **last 3 days** will limit the list to only those topics which were posted in the last 3 days.
* **all time** will not limit the list in any way: all posts which have ever been posted will be included.
* **other period** allows you to select a custom time period to limit the list. You can enter a number of hours, or you can enter a number of days by typing a number followed by "d" ("6" = 6 hours; "6d" = 6 days).
By combining the sorting options and the time-based filter, you can customise which topics will be displayed, and how they will be displayed. For example:
* "Votes" + "30 days" will show you all topics posted in the past 30 days, with the highest-voted topics at the top of the list.
* "Comments" + "3 days" will show you all topics posted in the past 3 days, with the topics that have the most comments posted under them (the ones with the most discussion) at the top of the list.
* "New" + "24 hours" will show you all topics posted in the past 24 hours, with the most recently posted topics at the top of the list.
* "All activity" + "90 days" will show you all topics posted in the past 90 days, with the topics that have had comments posted under them most recently at the top of the list.
There is also a feature to set a sorting option as your default. If you change your sorting option, "Set as default" will appear. If you click on this, the new sorting option you have just created will become the default sorting option for the page you are currently viewing - whether this is the front page (including all groups), or the page for a specific group. You can set a different default sort for every group, and for the front page.
### Filtering the topics
You can filter out some types of topics and prevent them from appearing on your front page. You do this using [topic tags](https://tildes.net/~tildes.official/wiki/instructions/posting_on_tildes#tagging_topics).
All topics should have tags. They'll describe what the topic is about. Some of them will be geographic identifiers ("usa", "china", "india"), some will indicate the subject matter ("biology", "social media", "history"), and some will indicate the type of topic ("ask", "introductions", "casual"). If there's a category of topic you don't want to see on your front page, you can apply a tag-based filter to block those posts.
Go to your user page by clicking on your username at the top of the sidebar on the righthand side of the screen. In the sidebar of your user page, there is a link that says "Settings" under the Misc heading. Click on that to go to your User Settings page. Alternatively, click on [this link](https://tildes.net/settings).
On your User Settings page, there is a link that says "Define topic tag filters" (probably at the bottom of the page). Click on that.
The filter is a single text box. You type the tag(s) you want to filter out in that box. If you want to filter out news about the USA, type "usa". If you want to filter out political topics, type "politics". If you want to filter out introductions topics, type "introductions". And so on.
You can have more than one filter: separate each tag by a comma, such as "*usa, politics, introductions*". This will filter out posts which are about the USA *or* which are political *or* which are introductions. Each tag in your filter is independent of all other tags.
Then click on 'Save filtered tags'.
You can change this list at any time, by adding or deleting tags.
Reference: [You can now define topic tag filters, which will hide topics with certain tags by default in your listings](https://tildes.net/~tildes.official/2a9/you_can_now_define_topic_tag_filters_which_will_hide_topics_with_certain_tags_by_default_in_your)
Title: Tildes Groups
[TOC]
### Subscribing to a group
To see topics from a group on your front page, you must subscribe to it. There are two ways to subscribe to a group:
* On the front page, look in the sidebar for the button that says 'Browse the list of groups' (at the bottom). The 'Browse groups' page lists all groups on Tildes. At the right-hand side of the screen, each group has a 'subscribe' button if you're not subscribed to it; this shows 'unsubscribe' if you are already subscribed to the group. Click on 'subscribe' to add this group to your list of subscriptions. .
* [Navigate to the group](https://tildes.net/~tildes.official/wiki/instructions/navigating_tildes#viewing_a_group) you want to subscribe to. In the sidebar is a button that says 'subscribe' (next to the number of subscribers); this shows 'unsubscribe' if you are already subscribed to the group. Click on 'subscribe'.
### Unsubscribing from a group
To no longer see topics from a group on your front page, you must unsubscribe from it. There are two ways to unsubscribe from a group:
* On the front page, look in the sidebar for the button that says 'Browse the list of groups' (at the bottom). The 'Browse groups' page lists all groups on Tildes. At the right-hand side of the screen, each group has an 'unsubscribe' button if you're subscribed to it; this shows 'subscribe' if you are not subscribed to the group. Click on 'unsubscribe' to remove this group from your list of subscriptions.
* [Navigate to the group](https://tildes.net/~tildes.official/wiki/instructions/navigating_tildes) you want to unsubscribe from. In the sidebar is a button that says 'unsubscribe' (next to the number of subscribers); this shows 'subscribe' if you are not subscribed to the group. Click on 'unsubscribe' to remove this group from your list of subscriptions.
### Creating groups
It is not currently possible for users to create their own groups on Tildes. All groups and sub-groups must be created (for now) by the creator/founder/god Deimos. Even in the future, the ability to create groups and sub-groups will be greatly restricted. It will not be open to all and sundry.
Groups and sub-groups will be determined organically, as the site grows and as the need arises. The way to demonstrate the need for a group or sub-group is to post topics with the appropriate tag in a relevant existing group or sub-group. If a particular tag gets a lot of use, that is an indication to Deimos and possible group creators that there is a need for a group for this subject.
For example:
* If you want a group for baking, post topics in ~food with a tag of "baking" (to indicate the need for a sub-group ~food.baking).
* If you want a group for horror movies, post topics in ~movies with a tag of "horror" (to indicate the need for a sub-group ~movies.horror).
* If you want a group for esports, post topics in ~games with a tag of "esports" (to indicate the need for a sub-group ~games.computer.esports).
These previous discussions provide context for this:
* [Are we going to be able to make our own groups?](https://tildes.net/~tildes/qz/are_we_going_to_be_able_to_make_our_own_groups)
* [Creating new groups?](https://tildes.net/~tildes/17o/creating_new_groups)
* [How to start a new group?](https://tildes.net/~tildes/1c2/how_to_start_a_new_group)
* [Voting on future groups rather than anyone can create anything at anytime?](https://tildes.net/~tildes/1mq/)
* [Adding new groups](https://tildes.net/~tildes/1t6/adding_new_groups)
* [Adding new groups](https://tildes.net/~tildes/2ks/adding_new_groups)
* [Users thoughts on groups?](https://tildes.net/~tildes/4z8/users_thoughts_on_groups)
* [Daily Tildes discussion - new groups added, please subscribe to them if you're interested](https://tildes.net/~tildes.official/1e1/daily_tildes_discussion_new_groups_added_please_subscribe_to_them_if_youre_interested)
* [Daily Tildes discussion - proposals for "trial groups", round 1](https://tildes.net/~tildes.official/342/daily_tildes_discussion_proposals_for_trial_groups_round_1)
* [Four new groups added (and everyone subscribed): ~anime, ~enviro, ~humanities, and ~life](https://tildes.net/~tildes.official/3qv/four_new_groups_added_and_everyone_subscribed_anime_enviro_humanities_and_life)
* [Isn't the number of groups too restrictive?](https://tildes.net/~tildes/aas/isnt_the_number_of_groups_too_restrictive)
* [When will there be a group for photographers?](https://tildes.net/~tildes/aj1/when_will_there_be_a_group_for_photographers)
Title: User Settings
[TOC]
### Passwords
[Two-factor authentication is now available](https://tildes.net/~tildes.official/536/two_factor_authentication_is_now_available)
### Selecting a theme
[You can now set a default theme for your account (and still override on individual devices if you want)](https://tildes.net/~tildes.official/5mu/you_can_now_set_a_default_theme_for_your_account_and_still_override_on_individual_devices_if_you)
### Opening links
You can choose to always open a page (linked item, comments) in either a new tab or the current tab. This is determined by your user settings.
Go to your user page by clicking on your username at the top of the sidebar on the righthand side of the screen. In the sidebar of your user page, there is a link that says "Settings" under the Misc heading. Click on that to go to your User Settings page. Alternatively, click on [this link](https://tildes.net/settings).
On your User Settings page, look for a heading that says "**Open links in new tabs**". This has three options under it:
* Topic links to other websites
* Links to text topics and comments
* External links in topic, comment, and message text
If you tick the check box next to an option, this will automatically open those items in a new tab every time (if you tick next to "Topic links", all links will open in a new tab when you click on them). If the the check box is not ticked, those items will open in the current tab every time. You can set each option independently, or all the same.
Reference: [User settings are now available for opening links in new tabs](https://tildes.net/~tildes.official/3oi/user_settings_are_now_available_for_opening_links_in_new_tabs)
### Marking new comments
You can choose to highlight new comments in a thread (comments which have been posted since the last time you looked at the thread). By default, new comments are not marked in any way.
Go to your user page by clicking on your username at the top of the sidebar on the righthand side of the screen. In the sidebar of your user page, there is a link that says "Settings" under the Misc heading. Click on that to go to your User Settings page. Alternatively, click on [this link](https://tildes.net/settings).
On your User Settings page, look for a heading that says "**Configure marking new comments**". Click on this link to open the settings page for marking new comments.
There are two settings here:
* Track my last visit to each topic's comments and mark new comments
* Collapse old comments when I return to a topic
If you tick the "Track my last visit to each topic's comments and mark new comments" option, new comments will be identified in two ways:
* On your front page, under each topic, there is a description which says "X comments". Next to this, an extra description will show "(X new)", to tell you how many new comments have been posted under that topic since you last viewed it.
* In the topic page, new comments will be marked with a red line on their left border.
If you *also* tick the "Collapse old comments when I return to a topic" option, all old comments will be collapsed, so that only new comments are visible. You can restore any old comments by clicking on the "+" button on the comment stub.
Reference: [If you have the "mark new comments" feature enabled, old comments will now be collapsed when returning to a thread](https://tildes.net/~tildes.official/5oy/if_you_have_the_mark_new_comments_feature_enabled_old_comments_will_now_be_collapsed_when_returning)
### Bookmarks
You are able to save topics and comments for future reading and/or reference. You do this by bookmarking them.
Under every topic and comment, you will see a 'bookmark' link. Click on that to save the topic/comment to your bookmarks list.
To find a bookmarked item, go to your user page by clicking on your username at the top of the sidebar on the righthand side of the screen. In the sidebar of your user page, there is a link that says "Bookmarks" under the Misc heading. Click on that to go to your bookmarks list. Alternatively, click on [this link](https://tildes.net/bookmarks).