1 line
25 KiB
JSON
1 line
25 KiB
JSON
|
[{"id":0,"href":"/docs/automation-guidelines/","title":"Automation Guidelines","section":"Docs","content":"Last Updated\nOn: February 10th, 2024\nBy: Ategon\nAll Authors: Ategon\nAutomation Guidelines # These are guidelines to follow when using any form of automation on an account hosted on Programming.Dev (\u0026ldquo;programming.dev\u0026rdquo;, \u0026ldquo;we\u0026rdquo;, \u0026ldquo;us\u0026rdquo;, \u0026ldquo;our\u0026rdquo;) sites or in communities hosted on the site from federated instances. When using automation within communities on other instances make sure to follow their specific guidelines in addition to these if they exist.\nFailure to follow these guidelines may result in the account using the automation being banned from the instance.\n[!important] Guidelines marked with (C) can be overriden by community mods while ones marked with (A) can be overriden by a instance admin if they give permission to you.\n1. General Guidelines # This are guidelines that aren\u0026rsquo;t specific to one form of automation and should be followed regardless of the type of automation you are doing.\n1.1. Use Mentions as a Prefix # If the automation includes the usage of commands such as help, contact, remindme, generate, etc. it should use the mention of the account as the prefix as opposed to something such as ! or ?. This allows multiple automations to use the same commands without interfering with each other and ensures people are using the one they intended to use.\n1.2. No Trigger Overlap (C) # Do not make triggers fill the same niche as an already established one in the community you are posting in. For example if theres already a tldr bot posting tldrs for news posts there doesn\u0026rsquo;t need to be a second one in the comments. (Can be overriden by the community mods)\n1.3. No Vote Manupulation # Automation should not be used to affect the voting system in the instance. The vote it will automatically do on the accounts own posts are fine but it should not be used to automatically vote on other people\u0026rsquo;s posts or comments.\n2. Bots # These guidelines are specific to bot usage. This means accounts that exist solely to be automated to do things (tldr bot, remindme bot, reply bots, etc.) or that do specific things without any form of human intervention in the chain\n[!note] Examples of things in this category:\nAutomatically posting things from an rss feed Automatically generating tldrs of articles posted to a community Automatically posting a link to an alternate frontend for a site when theres a link to the site 2.1. Mark Bots as Bots # Bot accounts should be marked that they are a bot using the checkbox in the user settings\n2.2. Put Contact Info # The owner of the bot and some way to contact them must be in the bot’s bio\n2.3. Don\u0026rsquo;t Spam (A) # Bots should not spam posts or comments. Automatically making posts or comments is fine but it should not drown out non automation content. When looking at the last 20 posts in a community, at least 75% should be human created (your specific bot should take less than the 25% for bots since other bots exist to share that with). There are some cases where having a community with mostly or only bot content makes sense (e.g. daily programming quotes, a challenge community that auto posts daily challenges from another site) and in that case you should reach out to an instance admin to get it approved (and you should be one of the mods for that community). When admin approved it still should not drown out human posts in the local feed in the instance.\n2.4. Allow Mods to Opt In (A) # Before using a bot in a community allow the mod to opt in to the bots.\nIf a bot is deemed to be a well behaving bot that brings net good to the instance it can override this rule as long as it has been approved by an admin. If this happens mods should still be able to opt out of use of your bot.\n3. Tools # These guidelines are for tool usage for semi-automated actions or things that don\u0026rsquo;t affect other users.\n[!note] Examples of things in this category:\nScheduling p
|