packages/docusaurus-plugin-content-docs/src/docs.ts (5 lines):
	- line 168: // TODO legacy retrocompatibility
	- line 176: // TODO legacy retrocompatibility
	- line 192: // TODO is versioning the id very useful in practice?
	- line 410: // TODO legacy retro-compatibility due to old versioned sidebars using
	- line 418: // TODO legacy retro-compatibility due to old versioned sidebars using


packages/docusaurus/src/server/plugins/index.ts (4 lines):
	- line 107: // TODO this would be better to do all that in the codegen phase
	- line 108: // TODO handle context for nested routes
	- line 111: data: undefined, // TODO allow plugins to provide context data
	- line 160: // TODO alpha-60: remove this deprecated lifecycle soon


packages/docusaurus-theme-classic/src/validateThemeConfig.ts (4 lines):
	- line 254: // TODO temporary (@alpha-58)
	- line 259: // TODO temporary (@alpha-58)
	- line 287: // TODO temporary (@alpha-58)
	- line 312: // TODO infer this from reading the image


packages/docusaurus-theme-common/src/utils/useThemeConfig.ts (4 lines):
	- line 14: // TODO improve types, use unions
	- line 32: // TODO improve
	- line 109: // TODO we should complete this theme config type over time
	- line 113: // TODO temporary types


packages/docusaurus-plugin-content-docs/src/index.ts (3 lines):
	- line 226: // TODO tags should be a sub route of the version route
	- line 253: // TODO tags should be a sub route of the version route
	- line 292: // TODO tags should be a sub route of the version route


packages/docusaurus-theme-classic/src/getSwizzleConfig.ts (3 lines):
	- line 134: wrap: 'forbidden', /// TODO allow wrapping objects???
	- line 209: // TODO should probably not even appear here
	- line 229: // TODO how to describe this one properly?


packages/docusaurus-theme-classic/src/theme/Navbar/Content/index.tsx (3 lines):
	- line 23: // TODO temporary casting until ThemeConfig type is improved
	- line 63: // TODO stop hardcoding items?
	- line 71: // TODO stop hardcoding items?


packages/docusaurus-theme-classic/src/theme/SiteMetadata/index.tsx (3 lines):
	- line 22: // TODO move to SiteMetadataDefaults or theme-common ?
	- line 68: // TODO move to SiteMetadataDefaults or theme-common ?
	- line 91: // TODO maybe move these 2 themeConfig to siteConfig?


packages/docusaurus-plugin-pwa/src/registerSw.js (3 lines):
	- line 222: // TODO these events still works in chrome but have been removed from the spec
	- line 251: // TODO this event still works in chrome but has been removed from the spec
	- line 260: // TODO instead of default browser install UI, show custom docusaurus


packages/docusaurus-theme-common/src/utils/ThemeClassNames.ts (3 lines):
	- line 45: // TODO add other stable classNames here
	- line 65: // TODO add other stable classNames here
	- line 68: // TODO add other stable classNames here


packages/docusaurus/src/client/exports/Link.tsx (3 lines):
	- line 32: // TODO all this wouldn't be necessary if we used ReactRouter basename feature
	- line 83: // TODO read routes and automatically detect internal/external links?
	- line 89: // TODO we should use ReactRouter basename feature instead!


website/_dogfooding/testSwizzleThemeClassic.mjs (3 lines):
	- line 69: // TODO temp workaround: non-comps should be forbidden to wrap
	- line 147: // TODO require theme exhaustive config, fail fast?
	- line 149: // TODO provide util so that theme authors can also check exhaustiveness?


packages/docusaurus-theme-classic/src/theme/Navbar/MobileSidebar/PrimaryMenu/index.tsx (2 lines):
	- line 14: // TODO temporary casting until ThemeConfig type is improved
	- line 22: // TODO how can the order be defined for mobile?


jest.config.mjs (2 lines):
	- line 53: // TODO create dedicated testing utility for mocking contexts
	- line 56: // TODO use "projects" + multiple configs if we work on another theme?


packages/docusaurus-plugin-content-docs/src/sidebars/validation.ts (2 lines):
	- line 108: // TODO: Joi doesn't allow mutual recursion. See https://github.com/sideway/joi/issues/2611
	- line 142: // TODO: remove once with proper Joi support


packages/docusaurus-utils/src/webpackUtils.ts (2 lines):
	- line 68: // TODO avoid conflicts with the ideal-image plugin
	- line 69: // TODO this may require a little breaking change for ideal-image users?


packages/docusaurus-theme-classic/src/translations.ts (2 lines):
	- line 22: // TODO handle properly all the navbar item types here!
	- line 61: //  TODO handle properly all the navbar item types here!


packages/docusaurus-theme-classic/src/theme/DocSidebarItems/index.tsx (2 lines):
	- line 14: // TODO this item should probably not receive the "activePath" props
	- line 15: // TODO this triggers whole sidebar re-renders on navigation


packages/docusaurus-theme-classic/src/theme/DocCategoryGeneratedIndexPage/index.tsx (2 lines):
	- line 32: // TODO `require` this?
	- line 48: // TODO `require` this?


packages/docusaurus/src/server/configValidation.ts (2 lines):
	- line 157: // TODO move to @docusaurus/utils-validation
	- line 236: // TODO move to @docusaurus/utils-validation


packages/docusaurus-plugin-content-docs/src/sidebars/generator.ts (2 lines):
	- line 102: // TODO: try to use path.relative()
	- line 286: // TODO: the whole code is designed for pipeline operator


website/testCSSOrder.mjs (2 lines):
	- line 22: TODO we should probably add a real e2e test in core instead of using our own
	- line 27: // TODO temporary, the current order is bad and we should change/fix that


packages/docusaurus-theme-classic/src/theme/DocBreadcrumbs/index.tsx (2 lines):
	- line 19: // TODO move to design system folder
	- line 39: // TODO move to design system folder


packages/docusaurus-utils/src/tags.ts (2 lines):
	- line 30: // TODO maybe make ensure the permalink is valid url path?
	- line 97: // TODO: it's not really clear what should be the behavior if 2 tags have


packages/docusaurus-mdx-loader/src/index.ts (2 lines):
	- line 89: // TODO implementation can be completed/enhanced
	- line 100: // TODO do we have other use-cases than image assets?


packages/docusaurus/src/server/translations/translationsExtractor.ts (1 line):
	- line 32: // TODO support md/mdx too? (may be overkill)


packages/docusaurus/src/client/routeContext.tsx (1 line):
	- line 31: // TODO deep merge this


packages/docusaurus-theme-common/src/utils/docsUtils.tsx (1 line):
	- line 32: // TODO not ideal, see also "useDocs"


admin/scripts/generateExamples.mjs (1 line):
	- line 138: // TODO replace by starter repo in Docusaurus-community org (if we get it)


admin/scripts/image-resize.mjs (1 line):
	- line 46: // TODO integrate this as part of the script


packages/docusaurus-plugin-content-pages/src/markdownLoader.ts (1 line):
	- line 18: // TODO provide additional md processing here? like interlinking pages?


packages/docusaurus-theme-common/src/hooks/useTOCHighlight.ts (1 line):
	- line 11: // TODO make the hardcoded theme-classic classnames configurable (or add them


packages/docusaurus-remark-plugin-npm2yarn/src/index.ts (1 line):
	- line 93: // TODO change to export default after migrating to ESM


packages/docusaurus/src/commands/swizzle/config.ts (1 line):
	- line 26: // TODO deprecate getSwizzleComponentList later


packages/docusaurus-plugin-content-docs/src/sidebars/processor.ts (1 line):
	- line 79: // TODO repeatedly process & unwrap autogenerated items until there are no


packages/docusaurus-theme-classic/src/theme/DocPage/index.tsx (1 line):
	- line 80: // TODO: it should be removed from here


packages/docusaurus-utils-validation/src/validationSchemas.ts (1 line):
	- line 38: // TODO how can we make this emit a custom error message :'(


packages/docusaurus-utils/src/urlUtils.ts (1 line):
	- line 182: // TODO deduplicate: also present in @docusaurus/utils-common


packages/docusaurus-theme-classic/src/index.ts (1 line):
	- line 68: // TODO: import from theme-common once we only support Node.js with ESM support


packages/docusaurus-theme-common/src/contexts/colorMode.tsx (1 line):
	- line 29: // TODO legacy APIs kept for retro-compatibility: deprecate them


packages/docusaurus-plugin-content-docs/src/sidebars/utils.ts (1 line):
	- line 198: // TODO legacy id retro-compatibility!


packages/docusaurus-theme-common/src/utils/scrollUtils.tsx (1 line):
	- line 292: // TODO proper detection is currently unreliable!


website/src/remark/configTabs.mjs (1 line):
	- line 75: // TODO make this version-aware; maybe we need a


packages/docusaurus-plugin-content-docs/src/sidebars/types.ts (1 line):
	- line 212: // TODO should we allow "items" here? how would this work? would an


packages/docusaurus-utils/src/markdownUtils.ts (1 line):
	- line 42: // TODO: Find a better way to do so, possibly by compiling the Markdown content,


packages/docusaurus-theme-classic/src/theme/NavbarItem/NavbarNavLink.tsx (1 line):
	- line 28: // TODO all this seems hacky


packages/docusaurus-plugin-content-docs/src/versions.ts (1 line):
	- line 461: // TODO for retrocompatibility with existing behavior


packages/docusaurus-plugin-content-docs/src/translations.ts (1 line):
	- line 39: // TODO legacy, the sidebar name is like "version-2.0.0-alpha.66/docs"


packages/docusaurus-plugin-content-blog/src/frontMatter.ts (1 line):
	- line 58: // TODO enable deprecation warnings later


packages/docusaurus-theme-common/src/utils/useAlternatePageUtils.ts (1 line):
	- line 56: // TODO support correct alternate url when localized site is deployed on


packages/docusaurus/src/commands/swizzle/themes.ts (1 line):
	- line 76: // TODO recover from short theme-names here: "classic" => "@docusaurus/theme-classic"


website/docusaurus.config.js (1 line):
	- line 365: // TODO after we have forked prism-react-renderer, we should tweak the


packages/docusaurus-theme-classic/src/theme/BlogPostPage/index.tsx (1 line):
	- line 35: {/* TODO double check those article meta array syntaxes, see https://ogp.me/#array */}


packages/docusaurus/src/commands/swizzle/components.ts (1 line):
	- line 72: // TODO can probably be refactored


packages/docusaurus-migrate/src/frontMatter.ts (1 line):
	- line 69: // TODO this is not ideal to have to maintain such a list of allowed chars


packages/docusaurus-logger/src/index.ts (1 line):
	- line 150: // TODO remove when migrating to ESM


packages/docusaurus-theme-common/src/components/Details/styles.module.css (1 line):
	- line 24: /* TODO: deprecation, need to remove this after Safari will support `::marker` */


packages/docusaurus-plugin-content-docs/src/client/index.ts (1 line):
	- line 40: // TODO this feature should be provided by docusaurus core


packages/docusaurus-mdx-loader/src/remark/transformImage/index.ts (1 line):
	- line 71: // TODO remove this check once fixed in Yarn PnP


packages/docusaurus-utils-common/src/applyTrailingSlash.ts (1 line):
	- line 27: // TODO deduplicate: also present in @docusaurus/utils