Template
Difference between revisions of "Bot steps/Documentation"
< Template:Bot steps
(wmlang instead of isolang because the bot uses the Wikimedia code of the projects) |
(Some change, less than expected. Need to consider those : )) |
||
| Line 1: | Line 1: | ||
<noinclude><languages /></noinclude><translate><!--T:1--> | <noinclude><languages /></noinclude><translate><!--T:1--> | ||
| − | This | + | This'''steps for bot activation''' template track of the progress on the various localized bots. Actual development might slightly differ from the steps shown here. |
== General parameters == <!--T:2--> | == General parameters == <!--T:2--> | ||
| Line 7: | Line 7: | ||
# <tvar|wmlang><code>wmlang</code></>: code used by the Wikimedia projects of the target language. | # <tvar|wmlang><code>wmlang</code></>: code used by the Wikimedia projects of the target language. | ||
# <tvar|requester><code>requester</code></>: username of the requester. | # <tvar|requester><code>requester</code></>: username of the requester. | ||
| − | # <tvar| | + | # <tvar|programmer><code>programmer</code></>: username of the developer assigned to the request. |
# <tvar|botmaster><code>botmaster</code></>: username of the botmaster ([[User:Poslovitch|Poslovitch]] by default). | # <tvar|botmaster><code>botmaster</code></>: username of the botmaster ([[User:Poslovitch|Poslovitch]] by default). | ||
| Line 14: | Line 14: | ||
<!--T:5--> | <!--T:5--> | ||
# <tvar|request><code>request</code></>: The requester from an external wiki has posted their request on <tvar|1>[[LinguaLibre:Bot]]</> | # <tvar|request><code>request</code></>: The requester from an external wiki has posted their request on <tvar|1>[[LinguaLibre:Bot]]</> | ||
| − | # <tvar| | + | # <tvar|define><code>define</code></>: The request is taken into account, any additional information that would be needed for development is asked to the requester. |
| − | # <tvar|community-approval><code>community-approval</code></>: The requester ensures | + | # <tvar|community-approval><code>community-approval</code></>: The requester ensures the target wiki's community is aware and willing to use LinguaLibreBot. |
# <tvar|account><code>account</code></>: The botmaster creates the local LinguaLibreBot account on the target wiki. | # <tvar|account><code>account</code></>: The botmaster creates the local LinguaLibreBot account on the target wiki. | ||
# <tvar|code><code>code</code></>: The developer assigned to the request writes the script. | # <tvar|code><code>code</code></>: The developer assigned to the request writes the script. | ||
| Line 33: | Line 33: | ||
|- | |- | ||
| | | | ||
| + | <!-- Notes : | ||
| + | 1) these are key hints, descriptors do the clarifications ; | ||
| + | 2) move to verbs ? | ||
| + | 3) x= the action is "checked, ok, done" | ||
| + | 4) an hand of parameters may require their twin `action-url=` parameter. Ex: | ||
| + | - community-url = url to community discussion | ||
| + | - botflag-url = url to botflag discussion | ||
| + | 5) back up words ideas : | ||
| + | |ping=x (announce to individual) | ||
| + | |announce=x | ||
| + | |submit, submit-code, accept-code=x | ||
| + | |merge=x | ||
| + | |notify= | ||
| + | |help= | ||
| + | |wait= | ||
| + | |active= | ||
| + | --> | ||
<pre> | <pre> | ||
{{Bot cycle | {{Bot cycle | ||
|request=x | |request=x | ||
|define=x | |define=x | ||
| + | |community=x | ||
| + | |account=x | ||
|code=x | |code=x | ||
| − | | | + | |test=x |
| − | | | + | |botflag-request=x |
| − | | | + | |pr-created=x |
| − | | | + | |botflag-ok=x |
| − | | | + | |pr-merged=x |
| − | | | + | |deployed=x |
| − | | | + | |notification=x |
| + | |tested-real-conditions=x | ||
|wmlang=or | |wmlang=or | ||
| − | | | + | |requester=Psubhashish |
| − | |botmaster=Poslovitch | + | |programmer=Pamputt |
| + | |botmaster=Poslovitch | ||
}}</pre> | }}</pre> | ||
| | | | ||
Revision as of 20:08, 12 November 2021
Thissteps for bot activation template track of the progress on the various localized bots. Actual development might slightly differ from the steps shown here.
General parameters
wmlang: code used by the Wikimedia projects of the target language.requester: username of the requester.programmer: username of the developer assigned to the request.botmaster: username of the botmaster (Poslovitch by default).
Steps at creation
request: The requester from an external wiki has posted their request on LinguaLibre:Botdefine: The request is taken into account, any additional information that would be needed for development is asked to the requester.community-approval: The requester ensures the target wiki's community is aware and willing to use LinguaLibreBot.account: The botmaster creates the local LinguaLibreBot account on the target wiki.code: The developer assigned to the request writes the script.test: The developer assigned to the request tested their script on the target wiki.botflag-request: The bot flag for LinguaLibreBot has been requested on the target wiki, either after the tests ran by the developer, or before (in the event that the target wiki requires the intervention of stewarts).pr-created: The developer creates the pull request on GitHub.botflag-ok: The bot flag for LinguaLibreBot is granted.pr-merged: Once the code is tested and the bot flag is applied, the botmaster merges the pull request.deployed: The botmaster deploys the target wiki integration on Toolforge.notification: The botmaster or the developer notifies the requester and the community of the target wiki that the bot is active.tested-real-conditions: The bot has been successfully running on the target wiki for more than a week. Integration of the bot is deemed complete.
Template usage
| Code | Result | |
|---|---|---|
{{Bot cycle
|request=x
|define=x
|community=x
|account=x
|code=x
|test=x
|botflag-request=x
|pr-created=x
|botflag-ok=x
|pr-merged=x
|deployed=x
|notification=x
|tested-real-conditions=x
|wmlang=or
|requester=Psubhashish
|programmer=Pamputt
|botmaster=Poslovitch
}}
|
|