Repository: ManimCommunity/manim
File: manim/mobject/mobject.py (Python)

Code before:
        col_alignments
            The way each column of submobjects (from left to righht) is aligned horizontally.
            If defined the given string must only contain the following characters: "l"
            (left), "c" (centered) and "r" (right).
        row_heights
            Specific heights for certain rows (from top to bottom). The given list can contain
            `None`. In that case the corresponding row will fit its height automatically based
            on the highest element in that row.
        col_widths
            Specific widths for certain columns (from left to right). The given list can contain
            `None`. In that case the corresponding column will fit its width automatically based
            on the widest element in that column.
        flow_order
            The order in which the grid gets filled with the submobjects. Can be one of the
            following values: "rd", "dr", "ld", "dl", "ru", "ur", "lu", "ul". For example,
            "dr" (down right) means: Fill the table column by column downwards, filling the
            columns rigthwards. "u" and "l" stand for upwards and leftwards.

        .. note:: If either :code:`rows` or :code:`cols` is not defined, it is set to the length of either
            :code:`row_alignments` / :code:`col_alignments` or :code:`row_heights` / :code:`col_widths` if
            one of those is defined. If only one of :code:`rows` and :code:`cols` can be determined
            like this, the other will be choosen big enough to fit all submobjects.
            If neither :code:`cols` nor :code:`rows` is set implicitly, they will be choosen to be
            about the same, tending towards :code:`cols > rows` (simply because videos are wider
            then they are high).

        .. note:: If both :code:`cell_alignment` and either :code:`row_alignments` or :code:`col_alignments` is
            defined the latter has higher priority in its direction.


        Returns
        -------
        Mobject
            The mobject.

        Raises
        ------
        ValueError
            If rows and cols are choosen to small to fit all submobjetcs.
        ValueError
            :code:`cols`, :code:`col_alignments` and :code:`col_widths` or :code:`rows`,
            :code:`row_alignments` and :code:`row_heights` have mismatching sizes.

        Examples
        --------

        .. manim:: ArrangeInGrid
            :save_last_frame:

            class ArrangeInGrid(Scene):
                def construct(self):

Review comment (suggestion):
In my opinion this information is a little irrelevant for most users and can be determined through some light experimentation. It definitely feels more dev-facing. Maybe it would work better as an in-code comment?
```suggestion
```

Code after:
        col_alignments
            The horizontal alignment for each column (left to right). Accepts the following characters ``"l"`` - left,
            ``"c"`` - center, ``"r"`` - right.
        row_heights
            Defines a list of heights for certain rows (top to bottom). If the list contains
            ``None``, the corresponding row will fit its height automatically based
            on the highest element in that row.
        col_widths
            Defines a list of widths for certain columns (left to right). If the list contains ``None``, the
            corresponding column will fit its width automatically based on the widest element in that column.
        flow_order
            The order in which submobjects fill the grid. Can be one of the following values:
            "rd", "dr", "ld", "dl", "ru", "ur", "lu", "ul". ("rd" -> fill rightwards then downwards)

        Returns
        -------
        Mobject
            The mobject.

        NOTES
        -----

        If only one of ``cols`` and ``rows`` is set implicitly, the other one will be chosen big
        enough to fit all submobjects. If neither is set, they will be chosen to be about the same,
        tending towards ``cols`` > ``rows`` (simply because videos are wider than they are high).

        If both ``cell_alignment`` and ``row_alignments`` / ``col_alignments`` are
        defined, the latter has higher priority.


        Raises
        ------
        ValueError
            If ``rows`` and ``cols`` are too small to fit all submobjects.
        ValueError
            If :code:`cols`, :code:`col_alignments` and :code:`col_widths` or :code:`rows`,
            :code:`row_alignments` and :code:`row_heights` have mismatching sizes.

        Examples
        --------

        .. manim:: ArrangeInGrid
            :save_last_frame:

            class ArrangeInGrid(Scene):
                def construct(self):
                    #Add some numbered boxes:
                    np.random.seed(3)
                    boxes = VGroup(*[
                        Rectangle(WHITE, np.random.random()+.5, np.random.random()+.5).add(Text(str(i+1)).scale(0.5))
                        for i in range(22)