Experiment with moving the indexes around and toward the source tree

src/doc/en/reference/combinat/algebra.rst → src/doc/en/reference/combinat/algebraic_combinatorics.rst

@@ -1,17 +1,29 @@
-Combinatorial Algebras
-======================
+.. _algebraic_combinatorics:
+
+Algebraic combinatorics
+=======================
+
+- :class:`sage.combinat.diagram_algebras.PartitionAlgebra`
+
 
 .. toctree::
    :maxdepth: 2
 
-   ../sage/combinat/free_module
-   ../sage/combinat/combinatorial_algebra
    ../sage/combinat/descent_algebra
    ../sage/combinat/diagram_algebras
    ../sage/combinat/symmetric_group_algebra
    ../sage/combinat/symmetric_group_representations
+   ../sage/combinat/yang_baxter_graph
+
    ../sage/combinat/schubert_polynomial
    ../sage/combinat/partition_algebra
    ../sage/algebras/iwahori_hecke_algebra
    ../sage/algebras/nil_coxeter_algebra
    ../sage/algebras/affine_nil_temperley_lieb
+
+   ../sage/combinat/kazhdan_lusztig
+
+   ../symmetric_functions
+   ../ncsf_qsym
+   ../ncsym
+   ../sage/combinat/hall_polynomial

src/doc/en/reference/combinat/developer.rst

@@ -4,12 +4,10 @@ Developer Tools
 .. toctree::
    :maxdepth: 2
 
-   ../sage/combinat/backtrack
    ../sage/combinat/output
    ../sage/combinat/permutation_nk
    ../sage/combinat/split_nk
    ../sage/combinat/choose_nk
    ../sage/combinat/multichoose_nk
-   ../sage/combinat/tools
    ../sage/combinat/ranker
 

src/doc/en/reference/combinat/index.rst

@@ -1,162 +1,23 @@
 Combinatorics
 =============
 
-**Algebra**
+Introductory material
+---------------------
 
-.. toctree::
-   :maxdepth: 1
-
-   cluster_algebras
-   algebra
-
-**Backtracking solvers**
-
-.. toctree::
-   :maxdepth: 1
-
-   sage/combinat/tiling
-   sage/combinat/dlx
-   sage/combinat/matrices/dlxcpp
-
-**Compositions**
-
-.. toctree::
-   :maxdepth: 1
-
-   sage/combinat/composition_signed
-   sage/combinat/composition
-
-**Counting**
+- :mod:`sage.combinat`
+- :mod:`sage.combinat.tutorial`
 
-.. toctree::
-   :maxdepth: 1
-
-   sage/combinat/sloane_functions
-   sage/databases/oeis
-   sage/combinat/expnums
-   sage/combinat/combinat
-
-**Integer lists/matrices/vectors**
-
-.. toctree::
-   :maxdepth: 1
 
-   sage/combinat/integer_list
-   sage/combinat/integer_matrices
-   sage/combinat/integer_vector
-   sage/combinat/integer_vector_weighted
+Thematic indexes
+----------------
 
-**Partitions**
+- :ref:`algebraic_combinatorics`
 
-.. toctree::
-   :maxdepth: 1
-
-   partitions
-   sage/combinat/partition
-   sage/combinat/partition_tuple
-   sage/combinat/set_partition_ordered
-   sage/combinat/set_partition
-   sage/combinat/skew_partition
-   sage/combinat/vector_partition
-
-**Permutations**
+.. .. include:: sage/combinat/index.rst
 
 .. toctree::
    :maxdepth: 1
 
-   sage/combinat/permutation
-   sage/combinat/affine_permutation
-   sage/combinat/derangements
-   sage/combinat/integer_vectors_mod_permgroup
-   sage/combinat/enumeration_mod_permgroup
-
-**Symmetric functions**
-
-.. toctree::
-   :maxdepth: 1
-
-   symmetric_functions
-   ncsf_qsym
-   ncsym
-
-**Trees**
-
-.. toctree::
-   :maxdepth: 1
-
-   sage/combinat/abstract_tree
-   sage/combinat/ordered_tree
-   sage/combinat/binary_tree
-
-**Word**
-
-.. toctree::
-   :maxdepth: 1
-
-   words
-   sage/combinat/subword
-   sage/combinat/lyndon_word
-   sage/combinat/dyck_word
-
-
-**Unsorted**
-
-.. toctree::
-   :maxdepth: 1
-
-   sage/combinat/tutorial
-   sage/combinat/alternating_sign_matrix
-   sage/combinat/cartesian_product
-   sage/combinat/combination
-   sage/combinat/core
-   sage/combinat/debruijn_sequence
-   sage/combinat/degree_sequences
-   sage/combinat/tamari_lattices
-   sage/combinat/e_one_star
-   sage/combinat/finite_class
-   sage/combinat/hall_polynomial
-   sage/combinat/matrices/hadamard_matrix
-   sage/combinat/restricted_growth
-   sage/combinat/yang_baxter_graph
-   sage/combinat/gelfand_tsetlin_patterns
-   sage/combinat/graph_path
-   sage/combinat/matrices/latin
-   sage/combinat/necklace
-   sage/combinat/non_decreasing_parking_function
-   sage/combinat/parking_functions
-   sage/combinat/perfect_matching
-   sage/combinat/q_analogues
-   sage/combinat/q_bernoulli
-   sage/combinat/rsk
-   sage/combinat/sidon_sets
-   sage/combinat/six_vertex_model
-   sage/combinat/similarity_class_type
-   sage/combinat/subset
-   sage/combinat/subsets_pairwise
-
-   sage/combinat/tuple
-
-   sage/combinat/binary_recurrence_sequences
-
-   tableaux
-   root_systems
-
-   sage/combinat/kazhdan_lusztig
-   sage/combinat/knutson_tao_puzzles
-
-   crystals
-   posets
-   rigged_configurations
-   designs
-   species
-   developer
-   sage/combinat/finite_state_machine
-
-
-   sage/combinat/dict_addition
-   sage/combinat/misc
-   sage/combinat/combinatorial_map
-
-
+   module_list
 
 .. include:: ../footer.txt

src/doc/en/reference/combinat/module_list.rst

@@ -0,0 +1,122 @@
+Alphabetical module list
+========================
+
+Submodules
+----------
+
+.. toctree::
+   :maxdepth: 1
+
+   symmetric_functions
+   ncsf_qsym
+   posets
+   root_systems
+   crystals
+
+..   sage/combinat/ncsf_qsym/index
+..   sage/combinat/ncsym/index
+..   sage/combinat/posets/index
+..   sage/combinat/cluster_algebras/index
+..   sage/combinat/crystals/index
+..   sage/combinat/designs/index
+..   sage/combinat/rigged_configurations/index
+..   sage/combinat/root_systems/index
+..   sage/combinat/sf/index
+..   sage/combinat/species/index
+..   sage/combinat/words/index
+
+Modules
+-------
+
+.. toctree::
+   :maxdepth: 2
+
+   sage/algebras/affine_nil_temperley_lieb
+   sage/algebras/iwahori_hecke_algebra
+   sage/algebras/nil_coxeter_algebra
+   sage/combinat/abstract_tree
+   sage/combinat/affine_permutation
+   sage/combinat/alternating_sign_matrix
+   sage/combinat/binary_recurrence_sequences
+   sage/combinat/binary_tree
+   sage/combinat/cartesian_product
+   sage/combinat/combinat
+   sage/combinat/combination
+   sage/combinat/combinatorial_algebra
+   sage/combinat/combinatorial_map
+   sage/combinat/composition
+   sage/combinat/composition_signed
+   sage/combinat/core
+   sage/combinat/debruijn_sequence
+   sage/combinat/degree_sequences
+   sage/combinat/derangements
+   sage/combinat/descent_algebra
+   sage/combinat/diagram_algebras
+   sage/combinat/dict_addition
+   sage/combinat/dlx
+   sage/combinat/dyck_word
+   sage/combinat/e_one_star
+   sage/combinat/enumeration_mod_permgroup
+   sage/combinat/expnums
+   sage/combinat/finite_class
+   sage/combinat/finite_state_machine
+   sage/combinat/free_module
+   sage/combinat/gelfand_tsetlin_patterns
+   sage/combinat/graph_path
+   sage/combinat/hall_polynomial
+   sage/combinat/hall_polynomial
+   sage/combinat/integer_list
+   sage/combinat/integer_matrices
+   sage/combinat/integer_vector
+   sage/combinat/integer_vector_weighted
+   sage/combinat/integer_vectors_mod_permgroup
+   sage/combinat/k_tableau
+   sage/combinat/kazhdan_lusztig
+   sage/combinat/kazhdan_lusztig
+   sage/combinat/knutson_tao_puzzles
+   sage/combinat/lyndon_word
+   sage/combinat/matrices/dlxcpp
+   sage/combinat/matrices/hadamard_matrix
+   sage/combinat/matrices/latin
+   sage/combinat/misc
+   sage/combinat/necklace
+   sage/combinat/non_decreasing_parking_function
+   sage/combinat/ordered_tree
+   sage/combinat/parking_functions
+   sage/combinat/partition
+   sage/combinat/partition
+   sage/combinat/partition_algebra
+   sage/combinat/partition_tuple
+   sage/combinat/partition_tuple
+   sage/combinat/perfect_matching
+   sage/combinat/permutation
+   sage/combinat/q_analogues
+   sage/combinat/q_bernoulli
+   sage/combinat/restricted_growth
+   sage/combinat/ribbon
+   sage/combinat/ribbon_tableau
+   sage/combinat/rsk
+   sage/combinat/schubert_polynomial
+   sage/combinat/set_partition
+   sage/combinat/set_partition_ordered
+   sage/combinat/sidon_sets
+   sage/combinat/similarity_class_type
+   sage/combinat/six_vertex_model
+   sage/combinat/skew_partition
+   sage/combinat/skew_tableau
+   sage/combinat/sloane_functions
+   sage/combinat/subset
+   sage/combinat/subsets_pairwise
+   sage/combinat/subword
+   sage/combinat/symmetric_group_algebra
+   sage/combinat/symmetric_group_representations
+   sage/combinat/tableau
+   sage/combinat/tableau_tuple
+   sage/combinat/tamari_lattices
+   sage/combinat/tiling
+   sage/combinat/tuple
+   sage/combinat/tutorial
+   sage/combinat/vector_partition
+   sage/combinat/yang_baxter_graph
+
+.. include:: ../footer.txt

src/doc/en/reference/combinat/ncsf_qsym.rst

@@ -4,8 +4,8 @@ Non-Commutative Symmetric Functions and Quasi-Symmetric Functions
 .. toctree::
    :maxdepth: 2
 
-   ../sage/combinat/ncsf_qsym/tutorial
-   ../sage/combinat/ncsf_qsym/combinatorics
-   ../sage/combinat/ncsf_qsym/generic_basis_code
-   ../sage/combinat/ncsf_qsym/ncsf
-   ../sage/combinat/ncsf_qsym/qsym
+   sage/combinat/ncsf_qsym/tutorial
+   sage/combinat/ncsf_qsym/combinatorics
+   sage/combinat/ncsf_qsym/generic_basis_code
+   sage/combinat/ncsf_qsym/ncsf
+   sage/combinat/ncsf_qsym/qsym

src/doc/en/reference/combinat/partitions.rst

@@ -7,3 +7,4 @@ Partitions and Partition-like Objects
    sage/combinat/partition
    sage/combinat/partition_tuple
    sage/combinat/skew_partition
+   sage/combinat/core

src/doc/en/reference/combinat/posets.rst

@@ -10,3 +10,4 @@ Posets
    ../sage/combinat/posets/lattices
    ../sage/combinat/posets/linear_extensions
    ../sage/combinat/posets/poset_examples
+   ../sage/combinat/tamari_lattices