mirror of
https://github.com/Unleash/unleash.git
synced 2024-12-22 19:07:54 +01:00
ea930cd315
I keep getting confused and clicking the link to the how-to guides
when I wanna go to the API reference docs and I _wrote_ the damn thing
🙈 In other words, I betcha someone else is struggling with the same
thing.
So let's try and change it to something that's harder to click by mistake.
282 lines
11 KiB
JavaScript
282 lines
11 KiB
JavaScript
/**
|
|
* Creating a sidebar enables you to:
|
|
- create an ordered group of docs
|
|
- render a sidebar for each doc of that group
|
|
- provide next/previous navigation
|
|
|
|
The sidebars can be generated from the filesystem, or explicitly defined here.
|
|
|
|
Create as many sidebars as you want.
|
|
*/
|
|
|
|
module.exports = {
|
|
documentation: [
|
|
'user_guide/index',
|
|
{
|
|
label: 'First steps and tutorials',
|
|
type: 'category',
|
|
collapsed: false,
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'First steps',
|
|
description: 'Learn how and where to get started with Unleash.',
|
|
slug: '/tutorials',
|
|
},
|
|
items: [
|
|
'user_guide/unleash_overview',
|
|
'user_guide/important-concepts',
|
|
'user_guide/quickstart',
|
|
],
|
|
},
|
|
{
|
|
label: 'How-to guides',
|
|
collapsed: false,
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'How-to guides',
|
|
description: 'Step-by-step recipes for you to follow.',
|
|
slug: '/how-to',
|
|
},
|
|
items: [
|
|
{
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'How-to: Unleash API',
|
|
description: 'Learn how to work with the Unleash API',
|
|
slug: '/how-to/api',
|
|
},
|
|
label: 'Using the APIs',
|
|
items: ['user_guide/api-token', 'advanced/api_access'],
|
|
},
|
|
{
|
|
label: 'Feature toggles, strategies, context',
|
|
items: [
|
|
'how-to/how-to-add-strategy-constraints',
|
|
'user_guide/create_feature_toggle',
|
|
'how-to/how-to-define-custom-context-fields',
|
|
'how-to/how-to-use-custom-strategies',
|
|
],
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'How-to: general Unleash tasks',
|
|
description:
|
|
'Guides for how to perform general Unleash tasks.',
|
|
slug: '/how-to/misc',
|
|
},
|
|
},
|
|
{
|
|
label: 'Users and permissions',
|
|
items: [
|
|
'user_guide/user-management',
|
|
'how-to/how-to-create-and-assign-custom-project-roles',
|
|
],
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'How-to: users and permissions',
|
|
description: 'Users and permission how-to guides.',
|
|
slug: '/how-to/users-and-permissions',
|
|
},
|
|
},
|
|
{
|
|
label: 'Single Sign-On (SSO)',
|
|
items: [
|
|
'advanced/sso-open-id-connect',
|
|
'advanced/sso-saml',
|
|
'advanced/sso-saml-keycloak',
|
|
'advanced/sso-google',
|
|
],
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'How-to: Single Sign-On',
|
|
description: 'Single Sign-On how-to guides.',
|
|
slug: '/how-to/sso',
|
|
},
|
|
},
|
|
,
|
|
],
|
|
},
|
|
{
|
|
label: 'Reference documentation',
|
|
collapsed: false,
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'Reference documentation',
|
|
description:
|
|
'Technical reference documentation relating to Unleash, including APIs, SDKs, Unleash concepts and deployment.',
|
|
slug: '/reference',
|
|
},
|
|
items: [
|
|
{
|
|
type: 'category',
|
|
link: { type: 'doc', id: 'addons/index' },
|
|
items: [
|
|
'addons/datadog',
|
|
'addons/slack',
|
|
'addons/teams',
|
|
'addons/webhook',
|
|
],
|
|
label: 'Addons',
|
|
},
|
|
{
|
|
type: 'category',
|
|
link: { type: 'doc', id: 'api/index' },
|
|
label: 'APIs',
|
|
items: [
|
|
{
|
|
'Admin API': [
|
|
'api/admin/addons',
|
|
'api/admin/context',
|
|
'api/admin/events',
|
|
'api/admin/feature-toggles-v2',
|
|
'api/admin/feature-types',
|
|
'api/admin/features',
|
|
'api/admin/features-archive',
|
|
'api/admin/metrics',
|
|
'api/admin/projects',
|
|
'api/admin/state',
|
|
'api/admin/strategies',
|
|
'api/admin/user-admin',
|
|
],
|
|
'Client API': [
|
|
'api/client/features',
|
|
'api/client/metrics',
|
|
'api/client/register',
|
|
],
|
|
'System API': [
|
|
'api/internal/internal',
|
|
'api/internal/health',
|
|
],
|
|
},
|
|
'api/open_api',
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Client SDKs',
|
|
link: { type: 'doc', id: 'sdks/index' },
|
|
items: [
|
|
{
|
|
type: 'category',
|
|
label: 'Server-side SDKs',
|
|
items: [
|
|
'sdks/go_sdk',
|
|
'sdks/java_sdk',
|
|
'sdks/node_sdk',
|
|
'sdks/php_sdk',
|
|
'sdks/python_sdk',
|
|
'sdks/ruby_sdk',
|
|
{
|
|
type: 'link',
|
|
href: 'https://github.com/unleash/unleash-client-rust',
|
|
label: 'Rust SDK',
|
|
},
|
|
'sdks/dot_net_sdk',
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Client-side SDKs',
|
|
items: [
|
|
'sdks/android_proxy_sdk',
|
|
'sdks/proxy-ios',
|
|
'sdks/proxy-javascript',
|
|
'sdks/proxy-react',
|
|
],
|
|
},
|
|
{
|
|
type: 'link',
|
|
label: 'Community SDKs',
|
|
href: '/sdks#community-sdks',
|
|
},
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'Deployment and management of Unleash',
|
|
description:
|
|
'All you need to learn how to deploy and manage your own Unleash instance.',
|
|
slug: '/deploy',
|
|
},
|
|
label: 'Deploy and manage Unleash',
|
|
items: [
|
|
'deploy/getting_started',
|
|
'deploy/configuring_unleash',
|
|
'deploy/database-setup',
|
|
'deploy/database_backup',
|
|
'deploy/email',
|
|
'deploy/google_auth',
|
|
'deploy/import_export',
|
|
'deploy/migration_guide',
|
|
'deploy/securing_unleash',
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
label: 'Integrations',
|
|
link: { type: 'doc', id: 'integrations/integrations' },
|
|
items: [
|
|
{
|
|
'Jira Server': [
|
|
'integrations/jira_server_plugin_installation',
|
|
'integrations/jira_server_plugin_usage',
|
|
],
|
|
},
|
|
,
|
|
],
|
|
},
|
|
{
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'Unleash concepts',
|
|
description:
|
|
'Documents describing the inner parts of Unleash.',
|
|
slug: '/reference/concepts',
|
|
},
|
|
label: 'Unleash concepts',
|
|
items: [
|
|
'user_guide/activation_strategy',
|
|
'advanced/archived_toggles',
|
|
'advanced/audit_log',
|
|
'advanced/impression-data',
|
|
'advanced/custom_activation_strategy',
|
|
'user_guide/environments',
|
|
'advanced/feature_toggle_types',
|
|
'advanced/toggle_variants',
|
|
'user_guide/projects',
|
|
'user_guide/rbac',
|
|
'advanced/enterprise-authentication',
|
|
'advanced/stickiness',
|
|
'advanced/strategy_constraints',
|
|
'advanced/tags',
|
|
'user_guide/technical_debt',
|
|
'user_guide/unleash_context',
|
|
'sdks/unleash-proxy',
|
|
],
|
|
},
|
|
],
|
|
},
|
|
{
|
|
label: 'Topic guides',
|
|
collapsed: false,
|
|
type: 'category',
|
|
link: {
|
|
type: 'generated-index',
|
|
title: 'Topic guides',
|
|
description:
|
|
'Discussions, explanations, and explorations regarding topics related to Unleash.',
|
|
slug: '/topics',
|
|
},
|
|
items: ['topics/a-b-testing'],
|
|
},
|
|
],
|
|
};
|