mirror of
				https://github.com/Unleash/unleash.git
				synced 2025-10-27 11:02:16 +01:00 
			
		
		
		
	docs: switch order of api doc sidebar items; put legacy docs under legacy header (#4135)
Also adds a caution admonition to the legacy doc index page
This commit is contained in:
		
							parent
							
								
									1bee81b475
								
							
						
					
					
						commit
						9c7eadded0
					
				| @ -1,8 +1,14 @@ | ||||
| --- | ||||
| id: index | ||||
| title: API Documentation | ||||
| title: Legacy API Documentation | ||||
| --- | ||||
| 
 | ||||
| :::caution | ||||
| 
 | ||||
| The docs in this category are legacy documentation. You should prefer to use the [Unleash OpenAPI docs](/reference/api/unleash) instead whenever possible. | ||||
| 
 | ||||
| ::: | ||||
| 
 | ||||
| ## Client API {#client-api} | ||||
| 
 | ||||
| This describes the API provided to unleash-clients. | ||||
|  | ||||
| @ -181,39 +181,8 @@ module.exports = { | ||||
|                 }, | ||||
|                 { | ||||
|                     type: 'category', | ||||
|                     link: { | ||||
|                         type: 'doc', | ||||
|                         id: 'reference/api/legacy/unleash/index', | ||||
|                     }, | ||||
|                     label: 'APIs', | ||||
|                     items: [ | ||||
|                         { | ||||
|                             'Admin API': [ | ||||
|                                 'reference/api/legacy/unleash/admin/addons', | ||||
|                                 'reference/api/legacy/unleash/admin/context', | ||||
|                                 'reference/api/legacy/unleash/admin/events', | ||||
|                                 'reference/api/legacy/unleash/admin/features-v2', | ||||
|                                 'reference/api/legacy/unleash/admin/feature-types', | ||||
|                                 'reference/api/legacy/unleash/admin/features', | ||||
|                                 'reference/api/legacy/unleash/admin/archive', | ||||
|                                 'reference/api/legacy/unleash/admin/metrics', | ||||
|                                 'reference/api/legacy/unleash/admin/projects', | ||||
|                                 'reference/api/legacy/unleash/admin/segments', | ||||
|                                 'reference/api/legacy/unleash/admin/state', | ||||
|                                 'reference/api/legacy/unleash/admin/strategies', | ||||
|                                 'reference/api/legacy/unleash/admin/tags', | ||||
|                                 'reference/api/legacy/unleash/admin/user-admin', | ||||
|                             ], | ||||
|                             'Client API': [ | ||||
|                                 'reference/api/legacy/unleash/client/features', | ||||
|                                 'reference/api/legacy/unleash/client/metrics', | ||||
|                                 'reference/api/legacy/unleash/client/register', | ||||
|                             ], | ||||
|                             'System API': [ | ||||
|                                 'reference/api/legacy/unleash/internal/prometheus', | ||||
|                                 'reference/api/legacy/unleash/internal/health', | ||||
|                             ], | ||||
|                         }, | ||||
|                         { | ||||
|                             label: 'OpenAPI docs', | ||||
|                             collapsed: true, | ||||
| @ -227,6 +196,43 @@ module.exports = { | ||||
|                             }, | ||||
|                             items: require('./docs/reference/api/unleash/sidebar.js'), | ||||
|                         }, | ||||
|                         { | ||||
|                             type: 'category', | ||||
|                             label: 'Legacy API docs', | ||||
|                             link: { | ||||
|                                 type: 'doc', | ||||
|                                 id: 'reference/api/legacy/unleash/index', | ||||
|                             }, | ||||
|                             items: [ | ||||
|                                 { | ||||
|                                     'Admin API': [ | ||||
|                                         'reference/api/legacy/unleash/admin/addons', | ||||
|                                         'reference/api/legacy/unleash/admin/context', | ||||
|                                         'reference/api/legacy/unleash/admin/events', | ||||
|                                         'reference/api/legacy/unleash/admin/features-v2', | ||||
|                                         'reference/api/legacy/unleash/admin/feature-types', | ||||
|                                         'reference/api/legacy/unleash/admin/features', | ||||
|                                         'reference/api/legacy/unleash/admin/archive', | ||||
|                                         'reference/api/legacy/unleash/admin/metrics', | ||||
|                                         'reference/api/legacy/unleash/admin/projects', | ||||
|                                         'reference/api/legacy/unleash/admin/segments', | ||||
|                                         'reference/api/legacy/unleash/admin/state', | ||||
|                                         'reference/api/legacy/unleash/admin/strategies', | ||||
|                                         'reference/api/legacy/unleash/admin/tags', | ||||
|                                         'reference/api/legacy/unleash/admin/user-admin', | ||||
|                                     ], | ||||
|                                     'Client API': [ | ||||
|                                         'reference/api/legacy/unleash/client/features', | ||||
|                                         'reference/api/legacy/unleash/client/metrics', | ||||
|                                         'reference/api/legacy/unleash/client/register', | ||||
|                                     ], | ||||
|                                     'System API': [ | ||||
|                                         'reference/api/legacy/unleash/internal/prometheus', | ||||
|                                         'reference/api/legacy/unleash/internal/health', | ||||
|                                     ], | ||||
|                                 }, | ||||
|                             ], | ||||
|                         }, | ||||
|                     ], | ||||
|                 }, | ||||
|                 { | ||||
|  | ||||
		Loading…
	
		Reference in New Issue
	
	Block a user