All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
- Blocked search indexing with the
noindex
tag
- Removed the SearchBar and Logo components from TopNav.
- Crowdin file
- Search results pointing to urls with fixed version numbers, which might be outdated.
- Link
Next Article
andPrevious Article
to work with trailing slash.
- JSONC code snippets would not have sintax highlight.
- Support for
<!-- DOCS-IGNORE:start -->
and<!-- DOCS-IGNORE:end -->
tokens.
- Bump multiple package versions.
- Component grid would be rendered empty due to a variable being passed to the ComponentList query with the wrong value.
- Moved the
around
logic to more specific interfaces. - Renamed
docs-wrapper
tonavigation-wrapper
.
docs-ui.concepts
frominterfaces.json
.
- Fixed getting started url
- Fix a few links that were not moved from
docs
todocs-ui
- new interfaces name:
docs
todocs-ui
- Always adding trailing slash to URLs
- Filename with duplicated extension .md
customHeader
as a setting insettingsSchema
- Using
replace
when navigating to app's specific version. - Updating Sidebar verification if the current link is on.
- Support for
/docs/apps/functional
route.
- Support for new
/docs/concepts
route and content.
- Messages for
/docs/recipes/store-management
route.
- New
/docs/apps/:category
,/docs/apps/:category/:app(/:file)
,/docs/introduction/:article
and `/docs/concepts routes to acomodate new content organization. - Messages to render in each of these routes.
- Render would break if an empty markdown file was received by
DocsRenderer
component.
- Issue when opening a page already in cache
- Small UI adjustments
- Remove SearchBar from mobile Search page
- Show text instead of Icon in Getting Started "Previous Page" and "Next Page" buttons
- ✨ New fresh look
- search behavior when no query string is provided
- Search engine for mobile
- Parsed markdown headlines by #
- Styles builder major to
2.x
- Minor layout updates to code blocks.
- Broken
/docs/components/layout
page.
- Duplicated loading states on certain routes.
- Support for search functionality.
- Ordered list indexes being reset during rendering of the markdown content.
- Use
overflow-y-auto
instead ofoverflow-y-scroll
.
escapeHtml
set totrue
would render HTML as plain-text.
- Title tags in component pages being first headline of documentation
- Support for more programming languages through the use of
highlight.js
.
- Logic when to open sidebar subitems.
google analytics
pageview tracking onSideBar
- Message
docs/latest-features
.
- Changed top bar link and text to latest releases
- Overflow on mobile layout.
- Open
SideBarItem
behavior.
- Overall layout adjustments for v1.0 release.
- Query for
pixel
components fromcomponentsList
.
- Move
EnhancedAppVersionProvider
further down the component tree so thats its scope in more limited, avoiding unnecessary re-renders of theTopNav
component.
- Support for emojis on markdown.
- Move
EnhancedAppVersionProvider
down the component tree so thats its scope in more limited, avoiding unnecessary re-renders of the SideBar.
- Layout on
GettingStartedArticle
. - Broken layout on Safari desktop.
- Footer links.
ArticleNav
links would do nothing.
- Slug URLs for better SEO.
- Handling of active section on
SideBarItem
component. - Link to all recipes at
Home
.
RecipesList
can now show all available recipes onrecipes/all
.
- Remove
lorem
placeholders.
GettingStartedArticle
would always query for articles written in Portuguese.
- New
SideBarContext
component.
<Link>
component was being used withhref
attribute instead ofto
.
- Independent scrolling on
SideBar
and main content section. - Max-width to the
SideBar
to prevent it from stretching on widescreens.
- Broken message IDs being used by
ComponentsGrid
andRecipesList
- Support for displaying a complete list of available components on
ComponentsGrid
.
- Missing messages.
- New
AppDocs
component for/docs/app/:app(/:file)
and/docs/components/:category/:app
routes. EnhancedAppVersionProvider
to thePageLayoutContainer
component.
- Some messages that were missing.
- Missing Footer links.
- Dynamic
Latest Features
section in the homepage.
- Minor layout updates
- New navigation bar at the top of all pages.
SideBarItem
navigation indicator.
- Text colors for better accessibility.
- Inconsistent page layout.
- New
Recipes
section that lives at/docs/resources
and/docs/resources/:resource
.
- Full support for mobile navigation.
- New
GettingStartedArticle
component to live at/docs/getting-started/:track/:article
.
- New
ComponentDocs
page that lives at/docs/components/:category/:component(/:file)
.
- New
ComponentGrid
to visualize all available components under a certain category.
- Links in the SideBar now trim the file extensions to avoid requests with duplicate file extensions, such as
.md.md
.
- Update
vtex.docs-graphql
version to1.x
.
- New
RecipeView
page.
- Dynamic recipes listing page.
- New
RecipeList
GraphQL query.
- Better support for Chapters with multiple sub-levels in the SideBar.
- Unify
SideBar
andHomeSideBar
into a single component.
- Article navigation bar based on the headers present in the page.
- New Docs homepage.
- Clean-up unnecessary components.
- Clean-up and update Messages.
- Support for rendering raw HTMl from Markdown files.
- Support for 3 special CSS classes for highlighting text:
alert-info
alert-danger
alert-warning
react-markdown
is now used byDocsRenderer
component asremark-react
was removed.
- Version selection feature at
vtex.io/docs/:app(:/file)
.
- Support for relative links from one markdown file to another.
- App documentation url format to
/docs/:appName(/:fileName)
. - When no
:fileName
param is given, the UI defaults to show theREADME.md
file.
- Tag list taken from the markdown file front-matter in the
DocsRenderer
component. - Custom
<li>
tag for Remark. Edit this page on GitHub
link at the bottom of theAppDocs
page, using thegit
property taken from the markdown file front-matter.
- Links to
ID
s that were not lowercase would not work, now they do.
- Overall layout updates.
- New Under Construction page.
Docs
component is now rendered at/docs/home
./docs
rendersUnderConstruction
component.
- Inverted colors on
AppDocs
component. - Broken Navbar links
- Semantic colors defined in
styles/configs/style.json
.
- CustomCard component.
- Trigger new build for the Styles builder.
- Navbar links
- Remove apps that should not be used from
DocsData
.
- Initial implementation based on the one taken from
vtex-apps/landing-pages
.