Versioning
Each version of your docs can contain its own distinct tabs, sections, pages, and API references. Versions can share content, as well.
Add versions to your docs
Define your versions
Create a versions
folder inside of your fern
folder. To specify the contents of each version, add a .yml
file to the versions
folder to define the navigational structure of that version. Make sure to include the navigation
and tabs
properties, if applicable.
Version-specific yml
files:
Add your version configuration
Define a version in the top-level docs.yml
by adding an item to the versions
list and specifying the display-name
and path
.
Indicate availability
You can optionally set the availability status for each version. Options are deprecated
, ga
, stable
, and beta
.
Version availability is distinct from section and page availability, with different options. If you want to set section and page availability, do so in your version-specific yml
files.
Customize version selector styling
You can directly customize the appearance of the version selector by targeting the fern-version-selector
CSS class.
Common styling adjustments
Adjusting positioning:
Use transform: translateY(Npx)
to adjust the vertical positioning of the selectors. This ensures that the selectors match the line height of your logo for better visual alignment.
Enhancing visual prominence: You can modify the border radius and add borders to make the selectors more prominent and better integrated with your site’s design aesthetic.
Customize the dropdown
The dropdown menu for the version selector can be customized using the fern-version-selector-radio-group
CSS class.
