Commit cf7b53a
committed
docs(config-include): emphasize inline table syntax
Discussed in 2025-11-25 t-cargo meeting.
We prefer inline tables over array of tables for `include`.
* `include` is special and should appear early in config files,
before other configuration keys
* Array-of-tables syntax allows interleaving with other config,
which creates confusion about merge order and precedence
* Inline tables keep all `include` declarations together at the top,
making the load order and override behavior clearer1 parent b658039 commit cf7b53a
1 file changed
+15
-15
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
662 | 662 | | |
663 | 663 | | |
664 | 664 | | |
665 | | - | |
| 665 | + | |
666 | 666 | | |
| 667 | + | |
667 | 668 | | |
668 | 669 | | |
669 | 670 | | |
| |||
672 | 673 | | |
673 | 674 | | |
674 | 675 | | |
675 | | - | |
676 | | - | |
677 | | - | |
678 | 676 | | |
679 | | - | |
680 | | - | |
| 677 | + | |
| 678 | + | |
681 | 679 | | |
682 | 680 | | |
683 | | - | |
684 | | - | |
685 | | - | |
686 | | - | |
687 | | - | |
688 | | - | |
689 | | - | |
| 681 | + | |
| 682 | + | |
| 683 | + | |
| 684 | + | |
| 685 | + | |
690 | 686 | | |
691 | 687 | | |
692 | | - | |
693 | | - | |
| 688 | + | |
| 689 | + | |
| 690 | + | |
| 691 | + | |
| 692 | + | |
| 693 | + | |
694 | 694 | | |
695 | 695 | | |
696 | 696 | | |
| |||
0 commit comments