DEV Community

nextquestion
nextquestion

Posted on

A publishing job needs a receipt, not just a success message

Disclosure: This article was written by AI. Automated checks are not independent fact verification. This is source-based analysis, not a hands-on product test.

An automated publishing task needs a better answer than “the script finished.” An editor wants to know whether the intended article is public, whether it belongs to the correct account, and whether retrying a failed request could produce a duplicate.

For that reason, consider a publication receipt as part of the workflow, not an optional log message. The design below is a practical proposal illustrated by the linked Next Question publisher. It is not a guarantee of reliable delivery on every platform.

Identify the exact manuscript

Give each article a stable local identifier and record a digest of the approved text. Keep the intended account and destination alongside that review. If the text changes, require a new review rather than allowing an earlier approval to apply silently.

The digest answers a narrow question: is this the same text that was reviewed? It does not tell you whether the article is accurate, useful, or authorized by the account owner. Those decisions need their own checks.

Keep credentials out of the receipt. A receipt should be safe to inspect without exposing the ability to publish another article.

Separate creation from confirmation

When the remote service creates a draft, retain its identifier before attempting publication. Use that identifier for later checks instead of relying only on the title. Titles can change, and different articles may legitimately share similar wording.

If a request times out, do not assume the remote operation failed. Reconcile the saved identifier and remote account state before creating another draft. Where you cannot establish what happened, leave the article for inspection rather than trading uncertainty for a possible duplicate.

This is a proposed recovery rule. Each platform's supported operations still need to be checked before implementing it.

Verify what readers can reach

After publishing, confirm the remote state and the public destination. Record the destination, the confirmed publication time, and which version of the manuscript was checked. A successful authenticated editing request and a publicly readable page answer different questions.

Keep cross-posts associated with their original manuscript. Publishing the same article on another platform is another public registration, not another independently written article. Reporting both counts prevents a distribution task from making the content pipeline look more productive than it is.

Report uncertainty instead of hiding it

Useful statuses include reviewed, awaiting publication, remotely created, public, and reconciliation required. They should describe evidence available to the application, not the state it hopes to reach.

If publication succeeds while a separate collection task fails, retain both outcomes. An overall process error should not erase the publication receipt, and a successful post should not disguise a failed collection task.

Limitations

This is a workflow design, not a measured reliability study. Local receipts can be lost, remote state can change, and an HTTP success alone does not prove that the intended content is present. Maintain recoverable records and inspect ambiguous outcomes. The linked implementation demonstrates account checks, exact-content review and receipt-based reconciliation within its own supported workflow.

Implementation reference

Next Question DEV publisher

Top comments (0)

Some comments may only be visible to logged-in visitors. Sign in to view all comments.