This is an automated email from the ASF dual-hosted git repository. rnewson pushed a commit to branch improve-best-practice-doc in repository https://gitbox.apache.org/repos/asf/couchdb.git
commit c59726ff668b9b8d1c6c6d40868f2be924f0be79 Author: Robert Newson <[email protected]> AuthorDate: Thu Nov 6 15:18:45 2025 +0000 clarify the important step of this procedure --- src/docs/src/best-practices/views.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/src/docs/src/best-practices/views.rst b/src/docs/src/best-practices/views.rst index ffc8399e2..7fa9cdf4c 100644 --- a/src/docs/src/best-practices/views.rst +++ b/src/docs/src/best-practices/views.rst @@ -41,9 +41,12 @@ Here is a worked example, assuming your ``/db/_design/ddoc`` needs to be updated You can track the indexing progress via the ``/_active_tasks`` endpoint, or through the :ref:`fauxton` web interface. -4. When the index is done being built, re-upload the updated design document to - ``/db/_design/ddoc`` (or copy the document). The ``ddoc`` document will now - reference the same view indexes already built for ``_design/ddoc-new``. +4. Confirm the index is built by querying it (without ``stale=ok`` or ``update=false``) + and confirming you get view results. + +5. re-upload the updated design document to ``/db/_design/ddoc`` (or copy the + document). The ``ddoc`` document will now reference the same view indexes + already built for ``_design/ddoc-new``. 5. Delete ``/db/_design/ddoc-new`` and/or ``/db/_design/ddoc-old`` at your discretion. Don't forget to trigger :ref:`compact/views/cleanup` to reclaim
