Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-5401

Admin REST API -> default is not working

    XMLWordPrintable

Details

    • 1

    Description

      default is not working

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            Jayahari.Vavachan Jay Vavachan created issue -
            jamiltz James Nocentini made changes -
            Field Original Value New Value
            Component/s sync-gateway [ 14220 ]
            jamiltz James Nocentini made changes -
            Assignee Amarantha Kulkarni [ amarantha.kulkarni ] James Nocentini [ jamiltz ]
            jamiltz James Nocentini made changes -
            Component/s docs-site-ui [ 14710 ]
            Component/s sync-gateway [ 14220 ]
            jamiltz James Nocentini made changes -
            Assignee James Nocentini [ jamiltz ]
            jamiltz James Nocentini made changes -
            Link This issue relates to DOC-6017 [ DOC-6017 ]
            Ian.bridge Ian Bridge made changes -
            Assignee Ian Bridge [ ian.bridge ]
            Ian.bridge Ian Bridge added a comment - - edited

            Jay Vavachan  (see also DOC-6017) can you clarify, please? Are you saying that selecting API REFERENCES neither expands nor collapses the topic group, to allow selection of a topic? Or that selecting it does not display a topic?

            The latter is an (annoying) but integral feature; provision of content for the category headers is optional.

            The former would be a bug, but it is not one I can observe in Chrome 79.0.3945, Firefox 72.0.2 or Safari 13.0.4. Where I can expand the topic group and select, say, admin-rest-api.

            Ian.bridge Ian Bridge added a comment - - edited Jay Vavachan   (see also DOC-6017 ) can you clarify, please? Are you saying that selecting  API REFERENCES  neither expands nor collapses the topic group, to allow selection of a topic? Or that selecting it does not display a topic? The latter is an (annoying) but integral feature; provision of content for the category headers is optional. The former would be a bug, but it is not one I can observe in Chrome 79.0.3945, Firefox 72.0.2 or Safari 13.0.4. Where I can expand the topic group and select, say, admin-rest-api.
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 collector-de2e9313 needs-info
            Ian.bridge Ian Bridge made changes -
            Assignee Ian Bridge [ ian.bridge ] Jayahari Vavachan [ jayahari.vavachan ]
            Jayahari.Vavachan Jay Vavachan added a comment -

            this ticket was meant about, default option not expands nor collapse. I am using Firefox 72.0.2, and i cannot expand or collapse it.

            Jayahari.Vavachan Jay Vavachan added a comment - this ticket was meant about, default option not expands nor collapse. I am using Firefox 72.0.2, and i cannot expand or collapse it.
            Jayahari.Vavachan Jay Vavachan made changes -
            Assignee Jayahari Vavachan [ jayahari.vavachan ] Ian Bridge [ ian.bridge ]
            Ian.bridge Ian Bridge added a comment - - edited

            Thanks Jay Vavachan. Sorry I was a bit slow grasping the context. 

            I've looked at the yaml for this. At 2.1 the default category contained only a db_revs_diffs property. This had no tag to associate it to a category. At 2.5 a tag: database was added to db_revs_diffs, allowing it to be correctly grouped under the database category but now leaving default empty; hence although it does expand, its expanded content is nil.

            I don't know why, yet, we are showing the empty category and continue to investigate.

            Ian.bridge Ian Bridge added a comment - - edited Thanks Jay Vavachan . Sorry I was a bit slow grasping the context.  I've looked at the yaml for this. At 2.1 the  default category contained only a db_revs_diffs property. This had no tag to associate it to a category. At 2.5 a tag: database was added to db_revs_diffs , allowing it to be correctly grouped under the database category but now leaving default empty; hence although it does expand, its expanded content is nil. I don't know why, yet, we are showing the empty category and continue to investigate.
            Ian.bridge Ian Bridge made changes -
            Link This issue duplicates DOC-6017 [ DOC-6017 ]
            Ian.bridge Ian Bridge made changes -
            Link This issue is duplicated by DOC-6017 [ DOC-6017 ]
            Ian.bridge Ian Bridge added a comment - - edited

            Ben Brooks Jay Vavachan This ticket was duplicated by DOC-6017 I am going to close that ticket and progress a resolution on DOC-5401 (Release 2.5), which is when the issue first became noticeable. Although at the moment it is looking like a 'feature' of Swagger. 

            It seems the ‘default’ tag is a catchall that is output to cover any untagged operations (endpoints) and that it is output regardless of there being any or not

            That being the case we may need to address it in CSS.

            Ian.bridge Ian Bridge added a comment - - edited Ben Brooks Jay Vavachan This ticket was duplicated by  DOC-6017 I am going to close that ticket and progress a resolution on DOC-5401 (Release 2.5), which is when the issue first became noticeable. Although at the moment it is looking like a 'feature' of Swagger.  It seems the ‘default’ tag is a catchall that is output to cover any untagged operations (endpoints) and that it is output regardless of there being any or not https://github.com/swagger-api/swagger-ui/issues/1311 https://github.com/swagger-api/swagger-ui/issues/4879 That being the case we may need to address it in CSS.
            Ian.bridge Ian Bridge made changes -
            Link This issue duplicates DOC-6017 [ DOC-6017 ]
            Ian.bridge Ian Bridge made changes -
            Link This issue relates to DOC-6017 [ DOC-6017 ]
            Ian.bridge Ian Bridge made changes -
            Link This issue is duplicated by DOC-6017 [ DOC-6017 ]
            Ian.bridge Ian Bridge made changes -
            Status Open [ 1 ] In Progress [ 3 ]
            Ian.bridge Ian Bridge made changes -
            Link This issue is duplicated by DOC-6017 [ DOC-6017 ]
            Ian.bridge Ian Bridge added a comment -

            To summarise progress so far:

            The mobile rest api (public and admin) is showing an empty 'tag' default. This manifests as a default group that seems not to expand when clicked.

            The issue became visible in Release 2.5. Prior to Release 2.5 the default tag showed a revs_diffs endpoint. But since that endpoint was properly tagged in 2.5 DOC-3851 the default is now empty.

            From swagger documentation, it seems the ‘default’ tag is a catchall that is output to cover any untagged operations (endpoints) and that it is output regardless of there being any or not:

            This may need to be addressed in CSS.

            Ian.bridge Ian Bridge added a comment - To summarise progress so far: The mobile rest api (public and admin) is showing an empty 'tag' default. This manifests as a default group that seems not to expand when clicked. The issue became visible in Release 2.5. Prior to Release 2.5 the default tag showed a revs_diffs endpoint. But since that endpoint was properly tagged in 2.5 DOC-3851 the default is now empty. From swagger documentation, it seems the ‘ default ’ tag is a catchall that is output to cover any untagged operations (endpoints) and that it is output regardless of there being any or not: https://github.com/swagger-api/swagger-ui/issues/1311 https://github.com/swagger-api/swagger-ui/issues/4879 This may need to be addressed in CSS.
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 needs-info collector-de2e9313 mobDocPickList needs-info
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 mobDocPickList needs-info collector-de2e9313 mobDocThisSprint needs-info
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 mobDocThisSprint needs-info collector-de2e9313 mobDocThisSprint
            Ian.bridge Ian Bridge made changes -
            Affects Version/s Mobile 2.7 [ 16312 ]
            Ian.bridge Ian Bridge made changes -
            Component/s documentation [ 11812 ]
            Component/s Mobile [ 12832 ]
            Component/s sync-gateway [ 14220 ]
            Component/s docs-site-ui [ 14710 ]
            Ian.bridge Ian Bridge made changes -
            Status In Progress [ 3 ] Open [ 1 ]
            Ian.bridge Ian Bridge made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ]
            Priority Test Blocker [ 6 ]
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 mobDocThisSprint collector-de2e9313
            Ian.bridge Ian Bridge made changes -
            Sprint DOC-2020-S6-Apr05 [ 1012 ]
            Ian.bridge Ian Bridge made changes -
            Sprint DOC-2020-S7-Apr19 [ 1021 ]
            Ian.bridge Ian Bridge made changes -
            Rank Ranked higher
            Ian.bridge Ian Bridge made changes -
            Sprint DOC-2020-S7-Apr19 [ 1021 ] DOC-2020-S8-May03 [ 1031 ]
            Ian.bridge Ian Bridge made changes -
            Sprint DOC-2020-S8-May03 [ 1031 ]
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 collector-de2e9313 mobDocNextSprint+1
            brett19 Brett Lawson made changes -
            Story Points 1
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 mobDocNextSprint+1 collector-de2e9313

            Ian Bridge, Jay Vavachan Is this a blocker issue?

            priya.rajagopal Priya Rajagopal added a comment - Ian Bridge , Jay Vavachan  Is this a blocker issue?
            Ian.bridge Ian Bridge added a comment -

            Priya Rajagopal Jay Vavachan

            I think it's a quirk, a possible minor distraction. It's a link that appears not to work because it has no content. I haven't found a way to suppress it, but maybe we can add a dummy entry in Default that states it is 'intentionally empty' or that 'No default entries are defined' so at least if anyone does click on it, they have an explanation. 

            Ian.bridge Ian Bridge added a comment - Priya Rajagopal Jay Vavachan I think it's a quirk, a possible minor distraction. It's a link that appears not to work because it has no content. I haven't found a way to suppress it, but maybe we can add a dummy entry in Default that states it is 'intentionally empty' or that 'No default entries are defined' so at least if anyone does click on it, they have an explanation. 
            priya.rajagopal Priya Rajagopal added a comment - - edited

            Any reason why we need to have that empty tag default ? If thats removed, then  this section wouldn't show

             

            Also, not sure why this is was a Blocker issue  to begin with (In the bigger scheme of things , would appear far more pressing issues to be resolved. This is just an empty section that doesn't expand)

            priya.rajagopal Priya Rajagopal added a comment - - edited Any reason why we need to have that empty tag default ? If thats removed, then  this section wouldn't show   Also, not sure why this is was a Blocker issue  to begin with (In the bigger scheme of things , would appear far more pressing issues to be resolved. This is just an empty section that doesn't expand)
            priya.rajagopal Priya Rajagopal made changes -
            Priority Test Blocker [ 6 ] Minor [ 4 ]

            Ian Bridge unless you disagree, I view this as a minor issue...at most major issue.

            priya.rajagopal Priya Rajagopal added a comment - Ian Bridge  unless you disagree, I view this as a minor issue...at most major issue.
            Ian.bridge Ian Bridge made changes -
            Fix Version/s Mobile 3.0 [ 17243 ]
            Ian.bridge Ian Bridge made changes -
            Due Date 24/Sep/21
            Ian.bridge Ian Bridge made changes -
            Issue Type Bug [ 1 ] New Feature [ 2 ]
            Ian.bridge Ian Bridge made changes -
            Issue Type New Feature [ 2 ] Bug [ 1 ]
            Ian.bridge Ian Bridge made changes -
            Labels collector-de2e9313 LithiumDoc collector-de2e9313 mobile mobsprintnext
            Ian.bridge Ian Bridge made changes -
            Labels LithiumDoc collector-de2e9313 mobile mobsprintnext LithiumDoc collector-de2e9313 mobile
            Ian.bridge Ian Bridge made changes -
            Labels LithiumDoc collector-de2e9313 mobile LithiumDoc collector-de2e9313 ib_radar mobile
            Ian.bridge Ian Bridge made changes -
            Resolution Fixed [ 1 ]
            Status Open [ 1 ] Closed [ 6 ]

            People

              Ian.bridge Ian Bridge
              Jayahari.Vavachan Jay Vavachan
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Gerrit Reviews

                  There are no open Gerrit changes

                  PagerDuty