From fa5fce2b8a9e9875dc4f545e1f82863bee904c8c Mon Sep 17 00:00:00 2001 From: gravel Date: Fri, 19 Jan 2024 15:27:28 +0000 Subject: [PATCH] docs: extend sogops recommendations --- for-sogops.md | 32 ++++++++++++++++++++++++++------ 1 file changed, 26 insertions(+), 6 deletions(-) diff --git a/for-sogops.md b/for-sogops.md index d1da574..330a3d4 100644 --- a/for-sogops.md +++ b/for-sogops.md @@ -1,5 +1,7 @@ # Recommendations for SOGS Operators +**TL;DR**: [Appoint mods](#moderating-abuse); [keep in touch](#communication-channels); [tag your room right](#community-tags) (`#nsfw` and `#test`); [and above all, follow the rules](README.md#policy). + ## Moderating abuse **Abuse is a very real problem on Session. Make sure to appoint sufficient moderators to your Communities**. @@ -15,11 +17,29 @@ If you operate a Session Group Server, it is recommended that: **Cooperation with SOGS Operators is crucial to prevent abuse**. (As well as to enrich Session as a whole). -## Useful features +## Customization + +### First steps + +Make your Community look more legitimate by setting a name and description. + +Don't know how to set up a room with a name and description? Check the [official documentation](https://github.com/oxen-io/session-pysogs/blob/stable/administration.md#creating-a-room). + +Forgot to set a description? Update it like so: + +```sh +sogs --rooms MY_ROOM_ID --description "New description goes here #lang:en #privacy" +``` + +Forgot to set a name? The following command might just save you (just replace the bits in uppercase): + +```sh +sqlite3 /var/lib/session-open-group-server/sogs.db 'update rooms set name="MY_ROOM_NAME" where token="MY_ROOM_ID";' +``` ### Community tags -Due to the lack of progress on the [issue of built-in Community tags](https://github.com/oxen-io/session-pysogs/issues/187), you may instead insert tags at the end of your room description like so: +You may insert tags at the end of your room description like so: ```This is a cool chatroom. #cool #chat #free``` @@ -27,15 +47,15 @@ The obvious benefit is searchability. However, tags such `#nsfw` or `#test` also The `#nsfw` tag hides the Community avatar and ensures visitors know your Community is not safe for work, while the `#test` tag marks a Community as "intended for testing" and hides it from our index. The `#unlisted` tag can be used for the same purpose, such as when archiving Communities. -#### Language tags +### Language tags Mark your Community with a language flag emoji by adding a tag of the form `#lang:CODE` at the end of your Community description. You can use any two-letter **country code**, or any of these prepared language codes: -- `lang:any` or `lang:all` for 🌐, -- `lang:en` for 🇬🇧, and -- `lang:zh` for 🇨🇳. +- `#lang:any` or `#lang:all` for 🌐, +- `#lang:en` for 🇬🇧, and +- `#lang:zh` for 🇨🇳. ### Server-wide icons