Skip to content

DOC-14382 channel history#973

Open
iamfortune wants to merge 29 commits into
release/4.1from
DOC-14382-channel-history-p1
Open

DOC-14382 channel history#973
iamfortune wants to merge 29 commits into
release/4.1from
DOC-14382-channel-history-p1

Conversation

@iamfortune

@iamfortune iamfortune commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Docs Issue: DOC-14382

PR to add channel history for GSW 4.1

Preview URL:
https://preview.docs-test.couchbase.com/docs-sync-gateway-DOC-14382-channel-history-p1

You will need the Docs Team credentials on Confluence.

@iamfortune iamfortune requested review from adamcfraser and gregns1 June 2, 2026 13:26
@gregns1 gregns1 requested a review from RIT3shSapata June 3, 2026 15:50

@RIT3shSapata RIT3shSapata left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The API specs have changed, please refer to the following for the latest API Spec:

  1. Document Channel history compaction
  2. User Channel history compaction

@adamcfraser would like your opinion on two things:

  1. Do we want to mention that this implementation is just a phase 1 implementation and then also add a note that this would be an automated process in a future release?
  2. Should the User's history compaction be called User Channel History Compaction or User Access History Compaction?

Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated
Comment thread modules/manage/pages/channel-history.adoc Outdated

@RIT3shSapata RIT3shSapata left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The API specs have changed, please refer to the following for the latest API Spec:

  1. Document Channel history compaction
  2. User Channel history compaction

@adamcfraser would like your opinion on two things:

  1. Do we want to mention that this implementation is just a phase 1 implementation and then also add a note that this would be an automated process in a future release?
  2. Should the User's history compaction be called User Channel History Compaction or User Access History Compaction?

Comment thread modules/ROOT/nav.adoc

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another thing that I just noticed is that the Channel compaction is missing from the bottom of the page:

Image

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've updated this with the current filename but will change depending on feedback from @adamcfraser on the specific name for this feature/file.

iamfortune and others added 23 commits June 8, 2026 13:26
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
iamfortune and others added 5 commits June 8, 2026 13:52
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>
Co-authored-by: Ritesh Sapata <34858159+RIT3shSapata@users.noreply.github.com>

@RIT3shSapata RIT3shSapata left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Everything LGTM, just a few changes in the name

For the full API reference, see xref:ROOT:rest_api_admin_static.adoc#tag/Document/operation/post_keyspace-_history_compact[POST /{keyspace}/_history/compact].


== User Channel History

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@iamfortune please rename this to User Access History

Suggested change
== User Channel History
== User Access History


== User Channel History

=== About User Channel History

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
=== About User Channel History
=== About User Access History

The operation does not affect the user's current channel access, does not modify underlying documents, and does not interrupt active continuous replications.


=== Retrieve User Channel History

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
=== Retrieve User Channel History
=== Retrieve User Access History

}
----

The response shows all channel history entries organised by scope and collection.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The response shows all channel history entries organised by scope and collection.
The response shows all access history entries organised by scope and collection.

For the full API reference, see xref:ROOT:rest_api_admin_static.adoc#tag/Database-Security/operation/get_db-_user-name-_access_history[GET /{db}/_user/{name}/_access_history].


=== Compact User Channel History

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
=== Compact User Channel History
=== Compact User Access History

}
----

The response confirms the channels removed from the user's history.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The response confirms the channels removed from the user's history.
The response confirms the channels removed from the user's access history.

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.

2 participants