Skip to content

Article Publish And Sync Procedure

Purpose

This procedure defines how to publish or update article-domain content through the article BFF.

Scope

  • article objects
  • article collections
  • collection membership

Procedure

Article Object

  1. Identify the target article by articleKey or current canonical slug.
  2. Query BFF for the current object state.
  3. Validate the intended fields against the live mutation contract.
  4. Use createArticle or updateArticle.
  5. Re-read the article and record the returned slug and timestamps.

Article Collection

  1. Identify the target collection by collectionKey.
  2. Query BFF for the current collection state.
  3. Use createArticleCollection or updateArticleCollection for collection metadata.
  4. Apply membership mutations with collection APIs.
  5. Re-read the collection and verify the returned member set.

Safe Publish Rule

Do not publish on ambiguous identity. Resolve duplicate or uncertain keys before write.

Contract Review Rule

When behavior is unclear, prefer:

  1. live BFF introspection
  2. live read/write verification
  3. repo docs as supporting reference