mirror of
https://github.com/zulip/zulip.git
synced 2025-11-03 13:33:24 +00:00
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
This directory contains scripts that are used in building, managing,
testing, and other forms of work in a Zulip development environment.
Note that tools that are also useful in production belong in
scripts/ or should be Django management commands.
For more details, see https://zulip.readthedocs.io/en/latest/overview/directory-structure.html.