Zinebot Operations

Included with Zinebot is a topics.txt file containing a copy of the meeting script. The next topic command will iteratively read the blocks of text listed in the topics.txt file and write them out in the chatroom. The text blocks in the file are separated by blank lines.

Some topics correlate with specific columns on the kanban board. When appropriate, Zinebot will scan the cards from the corresponding kanban board column and write them out to the chatroom as a summarized list. Included in the summary for each card will be an indication of whether or not the author has signed the Fedora Project Contributor Agreement (FPCA). The status of the author’s FPCA signature is retrieved directly from the Fedora Account System each time a card is retrieved from the kanban board.

Internally, Zinebot keeps track of which kanban column is currently being viewed. This command advances to the next column on the kanban board and lists its cards. Normally, this command should not be needed since the next topic command will take care of advancing to the appropriate column.

Internally, Zinebot keeps track of which card on the current kanban column is being viewed. This command advances to the next card in the column and displays its summary. If you want to view a specific card rather than iterating through them in order, see the view command below.

As a shorthand for this command, Zinebot will accept a lone unicode right-pointing arrow (→). The call sign should be omitted when using the shorthand.

This command allows you to skip to a specific topic. For example, skip topic agenda or skip topic 7. This command will reset the internal topic counter such that the result of a subsequent next topic command will be changed. Otherwise, this command behaves exactly like the next topic command.

When the to-edit column is loaded in the current internal card deck, this command will read the scheduled publication dates from all the cards in the deck and list them out along with the card titles and assigned editors as a proposed editing and publication schedule.

As a shorthand for this command, Zinebot will accept a lone unicode because symbol (∵). The call sign should be omitted when using the shorthand.

This command generates the same output as the proposed command described above. However, instead of starting with #proposed, the output will begin with #agreed.

In the background, this command will also post the agreed-upon publication schedule to Fedora Magazine’s channel on the Fedora Project Discourse forum. The success or failure of each attempted post is indicated by a respective 🔹 or 🔸 at the end of each scheduled card. Only articles that are scheduled for the upcoming week should post successfully. Anything that is scheduled for an earlier or later date should automatically fail to post.

As a shorthand for this command, Zinebot will accept a lone unicode therefore symbol (∴). The call sign should be omitted when using the shorthand.

This command scans the Fedora Project QA calendar for test day events and displays them in the chatroom. The scan is limited to a three-week period that begins on Sunday of the current week. Test day events are identified as those whose meeting location is set to fedora-test-day*.

This command scans the Fedora Project schedule for scheduled Fedora Magazine publications such as beta and final release announcements. The results are then listed in the chatroom.

This command generates a summarized list of kanban cards from either the current kanban column or, if specified, the requested kanban column. The next topic, skip topic and next column commands call this command automatically. When a specific column is requested, all subsequent Zinebot commands will consider it the current column.

Internally, the next card and view Zinebot commands operate against a cache of cards retrieved from the current kanban column rather than fetching them from Pagure each time. This command repopulates the internal cache whenever it is called. The current card is also reset to the first card in the list. If you modify any of the cards that are cached, you may need to rerun this command to update the internal cache.

This command does exactly the same thing as the next card command. However, unlike the latter, it allows you to specify a specific card number to display. The requested card must be loaded in the current card cache from a prior run of the list command. When a specific card is requested, the current card index for the next run of the next card command is not advanced.

This is a low-level command that allows you to access individual card properties. When provided a card number, this command operates directly against Pagure. This command can access cards that are not in the current column. The following card properties are accessible through this command.

By default, the last three comments are retrieved from the card when the comments property is requested. The number of comments to retrieve can be specified by appending :N to the property name where N is a positive integer. All card comments can be requested by appending :0 to the property name.

This command moves the specified card to the specified kanban column. Optionally, the row offset at which the card should be placed in the target column can be specified. By default, cards are moved to the top of the target column (row 1).

As a shorthand, you can use the unicode characters ← or → in place of the column name to signify the previous or next column respectively.

This command adds a one-line comment to the specified card. Pagure should send an email notification to the card’s assignee containing the comment. The comment does not need to be quoted. Everything after the card number is considered part of the comment.

This command posts an event to the Fedora Magazine calendar on Fedora’s Discourse forum. If the date is not specified, it defaults to one week from the current day. If the time is not specified, it defaults to the beginning of the current hour. Dates must be specified as YYYY-MM-DD. Times must be specified as HH:MM:SS. Times are in Coordinated Universal Time (UTC). The title does not need to be quoted. Anything that does not match a date or time pattern is considered part of the event title.

This command is called automatically by the show agreed command to add the agreed-upon articles to the publication calendar.

This command posts the editor of the week line. Just for fun, king and queen are aliases for this command. They may be easier to remember.