345 lines
14 KiB
HTML
345 lines
14 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en" dir="ltr">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<meta name="description" content="Last Updated
|
||
On: February 10th, 2024
|
||
By: Ategon
|
||
All Authors: Ategon
|
||
Automation Guidelines # These are guidelines to follow when using any form of automation on an account hosted on Programming.Dev (“programming.dev”, “we”, “us”, “our”) 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.
|
||
Failure to follow these guidelines may result in the account using the automation being banned from the instance.">
|
||
<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
|
||
<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#343a40">
|
||
<meta name="color-scheme" content="light dark"><meta property="og:title" content="" />
|
||
<meta property="og:description" content="Last Updated
|
||
On: February 10th, 2024
|
||
By: Ategon
|
||
All Authors: Ategon
|
||
Automation Guidelines # These are guidelines to follow when using any form of automation on an account hosted on Programming.Dev (“programming.dev”, “we”, “us”, “our”) 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.
|
||
Failure to follow these guidelines may result in the account using the automation being banned from the instance." />
|
||
<meta property="og:type" content="article" />
|
||
<meta property="og:url" content="https://example.com/docs/automation-guidelines/" /><meta property="article:section" content="docs" />
|
||
|
||
|
||
|
||
<title>Automation Guidelines | P.D Support</title>
|
||
<link rel="manifest" href="/manifest.json">
|
||
<link rel="icon" href="/logo.png" >
|
||
<link rel="stylesheet" href="/book.min.f8de3645fe00591b41524aee174e19edd98a22255a2930a0cdc82a94835ba387.css" integrity="sha256-+N42Rf4AWRtBUkruF04Z7dmKIiVaKTCgzcgqlINbo4c=" crossorigin="anonymous">
|
||
<script defer src="/flexsearch.min.js"></script>
|
||
<script defer src="/en.search.min.e8f882d8f145519fd2b41b93fe0dfe62c367052577b5401557a44a86f013beff.js" integrity="sha256-6PiC2PFFUZ/StBuT/g3+YsNnBSV3tUAVV6RKhvATvv8=" crossorigin="anonymous"></script>
|
||
<!--
|
||
Made with Book Theme
|
||
https://github.com/alex-shpak/hugo-book
|
||
-->
|
||
|
||
</head>
|
||
<body dir="ltr">
|
||
<input type="checkbox" class="hidden toggle" id="menu-control" />
|
||
<input type="checkbox" class="hidden toggle" id="toc-control" />
|
||
<main class="container flex">
|
||
<aside class="book-menu">
|
||
<div class="book-menu-content">
|
||
|
||
<nav>
|
||
<h2 class="book-brand">
|
||
<a class="flex align-center" href="/"><img src="/logo.png" alt="Logo" /><span>P.D Support</span>
|
||
</a>
|
||
</h2>
|
||
|
||
|
||
<div class="book-search">
|
||
<input type="text" id="book-search-input" placeholder="Search" aria-label="Search" maxlength="64" data-hotkeys="s/" />
|
||
<div class="book-search-spinner hidden"></div>
|
||
<ul id="book-search-results"></ul>
|
||
</div>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<p><strong>Documents</strong></p>
|
||
<ul>
|
||
<li><a href="/docs/automation-guidelines/"class=active>Automation Guidelines</a></li>
|
||
<li><a href="/docs/code-of-conduct/">Code of Conduct</a>
|
||
<!-- raw HTML omitted --></li>
|
||
</ul>
|
||
<p><strong>Other Sites</strong></p>
|
||
<ul>
|
||
<li><a href="https://stacks.programming.dev">Blog</a></li>
|
||
</ul>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</nav>
|
||
|
||
|
||
|
||
|
||
<script>(function(){var e=document.querySelector("aside .book-menu-content");addEventListener("beforeunload",function(){localStorage.setItem("menu.scrollTop",e.scrollTop)}),e.scrollTop=localStorage.getItem("menu.scrollTop")})()</script>
|
||
|
||
|
||
|
||
</div>
|
||
</aside>
|
||
|
||
<div class="book-page">
|
||
<header class="book-header">
|
||
|
||
<div class="flex align-center justify-between">
|
||
<label for="menu-control">
|
||
<img src="/svg/menu.svg" class="book-icon" alt="Menu" />
|
||
</label>
|
||
|
||
<strong>Automation Guidelines</strong>
|
||
|
||
<label for="toc-control">
|
||
|
||
<img src="/svg/toc.svg" class="book-icon" alt="Table of Contents" />
|
||
|
||
</label>
|
||
</div>
|
||
|
||
|
||
|
||
<aside class="hidden clearfix">
|
||
|
||
|
||
<nav id="TableOfContents">
|
||
<ul>
|
||
<li><a href="#1-general-guidelines">1. General Guidelines</a>
|
||
<ul>
|
||
<li><a href="#11-use-mentions-as-a-prefix">1.1. Use Mentions as a Prefix</a></li>
|
||
<li><a href="#12-no-trigger-overlap-c">1.2. No Trigger Overlap (C)</a></li>
|
||
<li><a href="#13-no-vote-manupulation">1.3. No Vote Manupulation</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#2-bots">2. Bots</a>
|
||
<ul>
|
||
<li><a href="#21-mark-bots-as-bots">2.1. Mark Bots as Bots</a></li>
|
||
<li><a href="#22-put-contact-info">2.2. Put Contact Info</a></li>
|
||
<li><a href="#23-dont-spam-a">2.3. Don’t Spam (A)</a></li>
|
||
<li><a href="#24-allow-mods-to-opt-in-a">2.4. Allow Mods to Opt In (A)</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#3-tools">3. Tools</a>
|
||
<ul>
|
||
<li><a href="#31-mark-that-you-use-automation">3.1. Mark That You Use Automation</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#do-we-make-updates-to-these-automation-guidelines">Do we Make Updates to these Automation Guidelines?</a></li>
|
||
<li><a href="#contact-us">Contact Us</a></li>
|
||
</ul>
|
||
</nav>
|
||
|
||
|
||
|
||
</aside>
|
||
|
||
|
||
</header>
|
||
|
||
|
||
|
||
<article class="markdown book-article"><p>Last Updated<br>
|
||
On: February 10th, 2024<br>
|
||
By: Ategon</p>
|
||
<p>All Authors: Ategon</p>
|
||
<h1 id="automation-guidelines">
|
||
Automation Guidelines
|
||
<a class="anchor" href="#automation-guidelines">#</a>
|
||
</h1>
|
||
<p>These are guidelines to follow when using any form of automation on an account hosted on Programming.Dev (“programming.dev”, “we”, “us”, “our”) 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.</p>
|
||
<p>Failure to follow these guidelines may result in the account using the automation being banned from the instance.</p>
|
||
<blockquote>
|
||
<p>[!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.</p>
|
||
</blockquote>
|
||
<h2 id="1-general-guidelines">
|
||
1. General Guidelines
|
||
<a class="anchor" href="#1-general-guidelines">#</a>
|
||
</h2>
|
||
<p>This are guidelines that aren’t specific to one form of automation and should be followed regardless of the type of automation you are doing.</p>
|
||
<h3 id="11-use-mentions-as-a-prefix">
|
||
1.1. Use Mentions as a Prefix
|
||
<a class="anchor" href="#11-use-mentions-as-a-prefix">#</a>
|
||
</h3>
|
||
<p>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.</p>
|
||
<h3 id="12-no-trigger-overlap-c">
|
||
1.2. No Trigger Overlap (C)
|
||
<a class="anchor" href="#12-no-trigger-overlap-c">#</a>
|
||
</h3>
|
||
<p>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’t need to be a second one in the comments. (Can be overriden by the community mods)</p>
|
||
<h3 id="13-no-vote-manupulation">
|
||
1.3. No Vote Manupulation
|
||
<a class="anchor" href="#13-no-vote-manupulation">#</a>
|
||
</h3>
|
||
<p>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’s posts or comments.</p>
|
||
<h2 id="2-bots">
|
||
2. Bots
|
||
<a class="anchor" href="#2-bots">#</a>
|
||
</h2>
|
||
<p>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</p>
|
||
<blockquote>
|
||
<p>[!note]
|
||
Examples of things in this category:</p>
|
||
<ul>
|
||
<li>Automatically posting things from an rss feed</li>
|
||
<li>Automatically generating tldrs of articles posted to a community</li>
|
||
<li>Automatically posting a link to an alternate frontend for a site when theres a link to the site</li>
|
||
</ul>
|
||
</blockquote>
|
||
<h3 id="21-mark-bots-as-bots">
|
||
2.1. Mark Bots as Bots
|
||
<a class="anchor" href="#21-mark-bots-as-bots">#</a>
|
||
</h3>
|
||
<p>Bot accounts should be marked that they are a bot using the checkbox in the user settings</p>
|
||
<h3 id="22-put-contact-info">
|
||
2.2. Put Contact Info
|
||
<a class="anchor" href="#22-put-contact-info">#</a>
|
||
</h3>
|
||
<p>The owner of the bot and some way to contact them must be in the bot’s bio</p>
|
||
<h3 id="23-dont-spam-a">
|
||
2.3. Don’t Spam (A)
|
||
<a class="anchor" href="#23-dont-spam-a">#</a>
|
||
</h3>
|
||
<p>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.</p>
|
||
<h3 id="24-allow-mods-to-opt-in-a">
|
||
2.4. Allow Mods to Opt In (A)
|
||
<a class="anchor" href="#24-allow-mods-to-opt-in-a">#</a>
|
||
</h3>
|
||
<p>Before using a bot in a community allow the mod to opt in to the bots.</p>
|
||
<p>If 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.</p>
|
||
<h2 id="3-tools">
|
||
3. Tools
|
||
<a class="anchor" href="#3-tools">#</a>
|
||
</h2>
|
||
<p>These guidelines are for tool usage for semi-automated actions or things that don’t affect other users.</p>
|
||
<blockquote>
|
||
<p>[!note]
|
||
Examples of things in this category:</p>
|
||
<ul>
|
||
<li>Scheduling posts</li>
|
||
<li>Monthly/Weekly repeated thread posts in a community</li>
|
||
<li>Auto marking posts with certain keywords as read for you (this one is more automated but only affects your own account)</li>
|
||
</ul>
|
||
</blockquote>
|
||
<h3 id="31-mark-that-you-use-automation">
|
||
3.1. Mark That You Use Automation
|
||
<a class="anchor" href="#31-mark-that-you-use-automation">#</a>
|
||
</h3>
|
||
<p>As some software doesn’t have this built in currently you can just put the information in your bio. This could be something such as “Some actions in this account are automated”, “Cyborg account”, or “Uses some automation tools”. You could also put what specific things you use if you want but it is not required. If the software supports marking an account as a cyborg you can use that instead.</p>
|
||
<h2 id="do-we-make-updates-to-these-automation-guidelines">
|
||
Do we Make Updates to these Automation Guidelines?
|
||
<a class="anchor" href="#do-we-make-updates-to-these-automation-guidelines">#</a>
|
||
</h2>
|
||
<p>We may update the Automation Guidelines from time to time. When we do, we will change the “Last Updated” date and author at the top of the page to indicate the date and author of the most recent changes. If we make changes we may notify you by posting a notice of such changes or by sending you a notification. We encourage you to review these Automation Guidelines periodically for any modifications.</p>
|
||
<h2 id="contact-us">
|
||
Contact Us
|
||
<a class="anchor" href="#contact-us">#</a>
|
||
</h2>
|
||
<p>If you have questions or concerns about these Automation Guidelines you should contact us at <a href="mailto:info@programming.dev">info@programming.dev</a>.</p>
|
||
</article>
|
||
|
||
|
||
|
||
<footer class="book-footer">
|
||
|
||
<div class="flex flex-wrap justify-between">
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
<script>(function(){function e(e){const t=window.getSelection(),n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)}document.querySelectorAll("pre code").forEach(t=>{t.addEventListener("click",function(){if(window.getSelection().toString())return;e(t.parentElement),navigator.clipboard&&navigator.clipboard.writeText(t.parentElement.textContent)})})})()</script>
|
||
|
||
|
||
|
||
|
||
</footer>
|
||
|
||
|
||
|
||
<div class="book-comments">
|
||
|
||
</div>
|
||
|
||
|
||
|
||
<label for="menu-control" class="hidden book-menu-overlay"></label>
|
||
</div>
|
||
|
||
|
||
<aside class="book-toc">
|
||
<div class="book-toc-content">
|
||
|
||
|
||
<nav id="TableOfContents">
|
||
<ul>
|
||
<li><a href="#1-general-guidelines">1. General Guidelines</a>
|
||
<ul>
|
||
<li><a href="#11-use-mentions-as-a-prefix">1.1. Use Mentions as a Prefix</a></li>
|
||
<li><a href="#12-no-trigger-overlap-c">1.2. No Trigger Overlap (C)</a></li>
|
||
<li><a href="#13-no-vote-manupulation">1.3. No Vote Manupulation</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#2-bots">2. Bots</a>
|
||
<ul>
|
||
<li><a href="#21-mark-bots-as-bots">2.1. Mark Bots as Bots</a></li>
|
||
<li><a href="#22-put-contact-info">2.2. Put Contact Info</a></li>
|
||
<li><a href="#23-dont-spam-a">2.3. Don’t Spam (A)</a></li>
|
||
<li><a href="#24-allow-mods-to-opt-in-a">2.4. Allow Mods to Opt In (A)</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#3-tools">3. Tools</a>
|
||
<ul>
|
||
<li><a href="#31-mark-that-you-use-automation">3.1. Mark That You Use Automation</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#do-we-make-updates-to-these-automation-guidelines">Do we Make Updates to these Automation Guidelines?</a></li>
|
||
<li><a href="#contact-us">Contact Us</a></li>
|
||
</ul>
|
||
</nav>
|
||
|
||
|
||
|
||
</div>
|
||
</aside>
|
||
|
||
</main>
|
||
|
||
|
||
</body>
|
||
</html>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|