Convert twitter-operator spec to Asciidoc (#21)

twitter-operator.md → twitter-operator.adoc

@@ -1,58 +1,57 @@
-@bisq_network Twitter operator
-========
+= Twitter operator
+:toc:
+:toclevels: 4
+:toc-placement!:
 
-Issue: [bisq-network/roles#21](https://github.com/bisq-network/roles/issues/21)
+Issue: https://github.com/bisq-network/roles/issues/21[bisq-network/roles#21]
 
+toc::[]
 
-Purpose
---------
+== Purpose
 
-To provide a single, authoritative and trustworthy [@bisq_network](https://twitter.com/bisq_network) Twitter account that anyone can:
+To provide a single, authoritative and trustworthy https://twitter.com/bisq_network[@bisq_network] Twitter account that anyone can:
 
  - follow, to stay up to date with bisq;
  - @mention, to reference bisq in conversation with others;
  - @mention, to ask questions about bisq and provide feedback
 
 
-Motivation
---------
+== Motivation
 
 Twitter is an important communication channel and news source for many people in bisq's larger community. Most bisq contributors operate personal Twitter accounts, but no one bisq contributor should, by default, maintain control over the official @bisq_network account. This document specifies the requirements for assuming the role of @bisq_network Twitter account operator, such that (a) potentially any contributor can fulfill the requirements with minimal time and effort, and (b) account followers get consistent, valuable from it.
 
 In general, the idea is that announcements, observations and opinions about the bisq network should come from contributors' own personal Twitter accounts, and that the primary role of the @bisq_network account is to follow these contributors and 'curate' their content by liking and retweeting it. This principle is expanded upon in various sections below.
 
 
-Privileges
---------
+== Privileges
 
-The operator SHALL maintain control of the @bisq_network and @bitsquare_ Twitter accounts.
+ - Control of the @bisq_network and @bitsquare_ Twitter accounts.
 
 
-General Requirements
---------
+== General Requirements
 
-### Bonding
+=== Bonding
 The operator MUST post a bond of **TBD** BSQ to assume this role.
 
-### Reporting
+=== Reporting
 The operator SHOULD post a monthly report in the form of a comment on the linked GitHub issue for this role. The report SHOULD include (but is not limited to):
 
  - A recap of the statistics available in Twitter Analytics;
  - Screenshot(s) from Twitter Analytics as appropriate;
  - Operator commentary
 
-### Collaboration
+=== Collaboration
 All tweets to and from the account are posted in the `#twitter` channel of the bisq Slack team. The operator SHOULD discuss tweets with other contributors in this channel, especially when in doubt whether or how to respond. If necessary, the operator MAY escalate specific tweets to specific contributors by reaching out to them directly. In any case, the operator SHOULD use their discretion in collaborating or escalating tweets in whatever way they see fit, so as to ensure an accurate and timely response to questions or comments about bisq on Twitter.
 
-### Compensation
-The operator MUST issue monthly BSQ compensation requests to cover the cost of their labor. For convenience, such reports MAY be kept concise, simply linking to the current month's report (as per [Reporting](#reporting) above).
+=== Compensation
+The operator MUST issue monthly BSQ compensation requests to cover the cost of their labor. For convenience, such reports MAY be kept concise, simply linking to the current month's report (as per link:#reporting[Reporting] above).
 
-### Automation
+=== Automation
 The operator MAY automate the fulfillment of any of the requirements in this document, as they see fit, so long as such automation does not degrade the quality of content coming out of the account.
 
-Note that any efforts to automate the operation of the account SHOULD be submitted as a separate compensation request, i.e. SHOULD NOT be grouped in with the operator's usual monthly compensation requests as described in [Compensation](#compensation) above.
+Note that any efforts to automate the operation of the account SHOULD be submitted as a separate compensation request, i.e. SHOULD NOT be grouped in with the operator's usual monthly compensation requests as described in link:#compensation[Compensation] above.
 
-### Delegation
+=== Delegation
 In case of extended absence not exceeding one month, the operator MAY delegate their responsibilities to another individual of their own choosing ("the delegate"). If the operator is unable to attend to their responsibilities during any such absence, then they MUST delegate their responsibilities as follows.
 
 The operator MUST mention that delegation is occurring, and for what duration, in a comment on this role's linked GitHub issue.
@@ -61,37 +60,35 @@ The delegate MUST carefully read and adhere to all requirements in this document
 
 The delegate MAY issue a compensation request for their services rendered.
 
-### Termination
+=== Termination
 The account operator MAY terminate their participation in this role by giving notice at least one month in advance.
 
 Notice of termination MUST be given in a comment on this role's linked GitHub issue. The reason for this requirement is to ensure that other individuals interested in playing this role can subscribe to that GitHub issue and know that they will hear about it if and when the current operator decides to leave.
 
 
-Special Requirements
---------
+== Special Requirements
 
-### Notifications
+=== Notifications
 The operator SHOULD set themselves up to receive Twitter notifications in whatever way they see fit, such that they are able to fulfill the requirements that follow below.
 
-### Messages
-
+=== Messages
 a.k.a. "direct messages" or "DMs"
 
-#### Sending DMs
+==== Sending DMs
 Pending further discussion, the account SHOULD NOT send any direct messages.
 
-#### Receiving DMs
-Because the account only follows bisq contributors (see [Following](#following) below), it is unlikely that the account will receive any direct messages at all. In the event that direct messages are received, the account SHOULD reply as the operator sees fit, providing that the reply is factual in nature, and not an expression of the operator's personal opinion or views.
+==== Receiving DMs
+Because the account only follows bisq contributors (see link:#following[Following] below), it is unlikely that the account will receive any direct messages at all. In the event that direct messages are received, the account SHOULD reply as the operator sees fit, providing that the reply is factual in nature, and not an expression of the operator's personal opinion or views.
 
-### Tweets
-The account SHOULD NOT tweet anything on its own. The logic behind this requirement is simple: the bisq network is not a person; it has no opinions of its own and it cannot make observations of its own; therefore it has nothing to tweet about. What the account SHOULD do is monitor bisq contributors' Twitter activity and retweet their bisq-related tweets (see [Retweets](#retweets)); it MAY also reply to and like certain tweets (see [Replies](#replies) and [Likes](#likes)).
+=== Tweets
+The account SHOULD NOT tweet anything on its own. The logic behind this requirement is simple: the bisq network is not a person; it has no opinions of its own and it cannot make observations of its own; therefore it has nothing to tweet about. What the account SHOULD do is monitor bisq contributors' Twitter activity and retweet their bisq-related tweets (see link:#retweets[Retweets]); it MAY also reply to and like certain tweets (see link:#replies[Replies] and link:#likes[Likes]).
 
-### Retweets
+=== Retweets
 The account SHOULD retweet bisq-related tweets from the people it follows, subject to the discretion of the account operator. Contributor tweets should not be "mechanistically" retweeted, but rather curated to avoid the account becoming repetitive or noisy, and to avoid retweeting negative or otherwise unproductive content.
 
 The account MUST retweet release announcements made by bisq network repository maintainers as soon as possible, and preferably immediately, but in any case within 24 hours.
 
-### Replies
+=== Replies
 The account SHOULD reply to tweets that ask @bisq_network a direct question. When feasible, the reply SHOULD contain the answer to the question being asked, but the reply MAY also simply redirect the questioner to a more appropriate venue, e.g. the bisq forum or a particular bisq repository's GitHub issues.
 
 The account MAY reply to tweets mentioning @bisq_network, if the operator believes that the most effective action would be to tweet a reply directly from the @bisq_network account.
@@ -100,12 +97,12 @@ The account SHOULD reply to tweets mentioning @bisq_network in order to correct
 
 The account SHOULD NOT engage in extended Twitter conversations and MUST NOT engage in contentious debate or argument. If extended conversation or "defense" of bisq is necessary, the account should let individual contributors engage from their own personal Twitter accounts.
 
-### Quotes
+=== Quotes
 The account MAY quote tweets if it is deemed by the account operator to be a more effective technique than retweeting or replying alone.
 
 Quoting MUST NOT be used to express the operator's personal opinions or observations (for the same reasons detailed in 'Tweeting' above), but MAY be used to express facts about the project.
 
-### Following
+=== Following
 The account MUST follow current bisq network contributors. A current contributor is anyone who has had a compensation request accepted in the preceding 3 months UNLESS the contributor (a) does not have a Twitter account, or (b) indicates they do not wish to be followed (see below).
 
 The account MAY follow any number of alumni contributors. An alumni contributor is anyone who has had a compensation request accepted in the past, but who has not had a request accepted in the last 3 months. The specific set of alumni contributors that is followed is left to the operator's discretion.
@@ -114,56 +111,56 @@ The account MUST unfollow anyone who indicates they do not want to be followed.
 
 The account MUST NOT follow anyone other than the accounts enumerated above.
 
-### Likes
+=== Likes
 The account MAY like any bisq-related tweet at the operator's discretion. The definition of "bisq-related" is also left to the operator's discretion, but the operator SHOULD take a conservative approach here. If in doubt, leave it out.
 
-### Moments
+=== Moments
 Pending further discussion, the account SHOULD NOT create or maintain any Moments. 
 
-### Lists
+=== Lists
 Pending further discussion, the account SHOULD NOT create or maintain any Lists. 
 
-### Profile
+=== Profile
 
-#### Username
+==== Username
 The account username MUST remain "@bisq_network".
 
-#### Name
+==== Name
 The name MUST be "bisq" and MUST NOT be amended to promote certain views, e.g. `[UASF]` or `[NO2X]` as is often done in the larger bitcoin/crypto community.
 
-#### Profile photo
+==== Profile photo
 The profile photo MUST remain the official "bisq cat" image.
 
-#### Header image
+==== Header image
 The header image MAY be changed at the operator's discretion, but the operator SHOULD discuss any such changes with a quorum of other contributors first to ensure rough consensus if the image is changing significantly.
 
-#### Bio
+==== Bio
 The bio MUST include the text “operated by @individual”, where @individual is the operator's username.
 
-#### Location
+==== Location
 The location MUST be "Decentralized".
 
-#### Birthday
+==== Birthday
 The birthday field SHOULD be left blank.
 
-#### Website
+==== Website
 The website field MUST be set to `https://bisq.network`.
 
-### Verification
-The @bisq_network account is not and CAN NOT become a verified account. Per [Twitter's verification documentation](https://support.twitter.com/articles/20174631), verifying organization or company accounts require "an organization or company email address". The bisq network is not a company or traditional organization and as such has no "organization email addresses".
+=== Verification
+The @bisq_network account is not and CAN NOT become a verified account. Per https://support.twitter.com/articles/20174631[Twitter's verification documentation], verifying organization or company accounts require "an organization or company email address". The bisq network is not a company or traditional organization and as such has no "organization email addresses".
 
-### Ads
+=== Ads
 The acccount SHALL NOT purchase any Twitter ads.
 
-### Analytics
-See [Reporting](#reporting) above.
+=== Analytics
+See link:#reporting[Reporting] above.
 
-### Settings and Privacy
+=== Settings and Privacy
 
-#### Account
+==== Account
 
-##### Login verification
+===== Login verification
 The account MUST have 2FA ("login verification") enabled at all times. The operator SHOULD configure the use of an authenticator app (e.g. Google Authenticator) instead of relying on SMS for 2FA, which is known to be insecure.
 
-### Other Twitter accounts
+=== Other Twitter accounts
 The operator will also be responsible for the legacy @bitsquare_ account, which is now inactive. The operator SHOULD subscribe to notifications from this account, but the operator SHOULD NOT tweet from this account.