mirror of
https://github.com/zulip/zulip.git
synced 2025-11-01 12:33:40 +00:00
2977bf364e
We want to follow the Astro way of doing things and the middleware was adding more magic + it was violating commonmark spec: https://spec.commonmark.org/0.31.2/#example-301. We insert FlattenList component where include files are being treated as part of ordered lists. Astro renders included files as it's own component, which would result in multiple ordered lists instead of a single list if we did not use this component. See the astro component file itself to know more how FlattenedSteps works. We are not inserting FlattenList component for files with !!! tip components, since we need to do it inside the include file. There are 4 such files at the time of writing this comment. `is_include_only_ordered_list` makes sure of that. We can do the conversion for it manually during cutover or in a followup PR. All unordered lists at the time of writing this comment are standalone components and we do not need to do any transformation for them. We also changed the order of conversion of include and main files. Include files are now being converted first to calculate include_files_info. Relevant topic: https://chat.zulip.org/#narrow/channel/19-documentation/topic/Stage.202.3A.20New.20syntax.20for.20imports
Help center (beta) documentation
This directory is part of an ongoing migration project to convert our help center documentation to use starlight and add search to the docs at the same time.
The status of the project can be tracked at this umbrella issue: https://github.com/zulip/zulip/issues/30450
If you are a developer, you can refer to /devtools page on your zulip
installation to know what commands to use to run the project for
development.