Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Holistic Discourse / forum post link handling. #1262

Open
wants to merge 14 commits into
base: main
Choose a base branch
from

Conversation

DFINITYManu
Copy link
Contributor

@DFINITYManu DFINITYManu commented Jan 31, 2025

  • There are several modalities now: omit, ask, supply an URL, or use Discourse.
  • Arguments for Discourse and forum post handling move to each individual command.
  • When the Discourse behavior fails to create a post, it will ask for the user, and it will update the post afterwards.
  • When a proposal fails, the user is reminded to delete any post that may have been created.
  • When a proposal succeeds, and the link was manually supplied by the user, the user is reminded to update the post.
  • Motion proposals have gained a formulaic forum post autocomposed based on the title and text of the proposal. We should create more of these so as to avoid having to compose forum posts by hand.
  • Formerly, new posts would be hidden by the update Discourse forum post call. Now, only posts submitted in reply to a topic are hidden after update.

To-do:

  • When using the modality Discourse, if a proposal failed, then delete the corresponding forum post. In principle this can be done easily for most calls (for all calls that wrap ic_admin.propose_*), but not all.

@DFINITYManu DFINITYManu requested a review from a team as a code owner January 31, 2025 15:44
* There are several modalities now: omit, ask, supply an URL, or use Discourse.
* Arguments for Discourse and forum post handling move to each individual command.
* When the Discourse behavior fails to create a post, it will ask for the user,
  *and* it will update the post afterwards.
* Motion proposals have gained a formulaic forum post autocomposed based on the
  title and text of the proposal.
* Formerly, new posts would be hidden by the update Discourse forum post call.
  Now, only posts submitted in reply to a topic are hidden after update.

To-do:

* When using the modality Discourse, if a proposal failed, then delete the
  corresponding forum post.
… proposals.

Rationale: the forum post link is already in the proposal.  Requiring a forum post to compose the proposal summary creates a chicken-and-egg problem whereby the proposal requires the forum post and the forum post requires the proposal.  Hacks in the codebase to get around that problem include, but are not limited to, generating the summary twice (once for test run and once for final run).

Removal of this makes the codebase cleaner and makes it harder to make a programming mistake that would result in no forum post, or the wrong forum post link, or a forum post without a proposal being submitted.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant