[IMP] ecommerce: add custom anchors, links and "see also" sections

This commit adds custom anchors, links and new see also sections

task-3212218

closes odoo/documentation#3718

X-original-commit: b7db89e77b
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>

content/applications/websites/ecommerce/checkout_payment_shipping/cart.rst

@@ -10,6 +10,9 @@ The :guilabel:`Add to Cart` button can be customized in multiple ways. You can:
 - Create additional 'Add to Cart / Buy Now' buttons;
 - Add an 'Order Again' button to the customer portal.
 
+.. seealso::
+   :doc:`checkout`
+
 'Add to Cart' action customization
 ==================================
 
@@ -22,9 +25,13 @@ the :guilabel:`Shop - Checkout Process` section, look for :guilabel:`Add to Cart
 the options.
 
 .. note::
-   If a product has **optional products**, the **dialog box** will always appear.
+   If a product has :doc:`optional products <../managing_products/cross_upselling>`, the **dialog
+   box** will always appear.
 
-.. todo:: add :ref: to optional products when published.
+.. seealso::
+   :doc:`../managing_products/catalog`
+
+.. _cart/prevent-sale:
 
 Replace 'Add to Cart' button by 'Contact Us' button
 ===================================================
@@ -34,10 +41,8 @@ of your choice.
 
 .. note::
    Hiding the :guilabel:`Add to Cart` button is often used by B2B eCommerces that need to restrict
-   purchases only to customers with an account, but still want to display an online product catalog
-   for those without.
-
-.. todo:: add :ref: to sign-up section doc when published to note
+   purchases only to :ref:`customers with an account <checkout-sign>`, but still want to
+   display an online product catalog for those without.
 
 To do so, go to :menuselection:`Website --> Configuration --> Settings --> Shop - Products` and tick
 :guilabel:`Prevent Sale of Zero Priced Product`. This creates a new :guilabel:`Button url` field
@@ -73,6 +78,8 @@ and place the building block. Once placed, you have the following options:
    :align: center
    :alt: Customizable 'Add to Cart' button
 
+.. _cart/buy-now:
+
 'Buy Now' button
 ================
 

content/applications/websites/ecommerce/checkout_payment_shipping/checkout.rst

@@ -89,6 +89,11 @@ The button can be found next to the :guilabel:`Add to Cart` button on the produc
    :align: center
    :alt: Buy now (express checkout) button
 
+.. seealso::
+   :ref:`Product page design: additional functions <ecommerce-functions>`
+
+.. _checkout-sign:
+
 Guest and signed-in checkout
 ============================
 

content/applications/websites/ecommerce/checkout_payment_shipping/payments.rst

@@ -6,6 +6,10 @@ Odoo supports a multitude of online
 :doc:`payment providers </applications/finance/payment_providers>` for your website, allowing your
 customers to pay with their preferred payment methods.
 
+.. seealso::
+   - :doc:`/applications/sales/sales/products_prices/ewallets_giftcards`
+   - :doc:`../checkout_payment_shipping/checkout`
+
 Configuration
 -------------
 

content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst

@@ -8,6 +8,9 @@ methods <ecommerce-own-shipping>`, or use an integration with an :ref:`existing
 
 .. _ecommerce-own-shipping:
 
+.. seealso::
+   :doc:`../checkout_payment_shipping/checkout`
+
 Own shipping methods
 ====================
 
@@ -65,6 +68,3 @@ Customers can choose the shipping method at the end of the checkout process, at
 .. image:: shipping/shipping-checkout.png
    :align: center
    :alt: Delivery method choice at checkout
-
-.. seealso::
-   :doc:`../checkout_payment_shipping/checkout`

content/applications/websites/ecommerce/managing_products/catalog.rst

@@ -34,6 +34,11 @@ category, the option :guilabel:`Collapsable Category Recursive` appears and allo
    :align: center
    :alt: Categories options for your eCommerce website
 
+.. seealso::
+   :doc:`products`
+
+.. _ecommerce-browsing:
+
 Browsing
 --------
 
@@ -157,7 +162,8 @@ or a **wishlist**. To do so, go to your **main shop page**, and at the end of th
 :guilabel:`Products Page` category, click on the feature buttons you wish to use. All three buttons
 appear when hovering the mouse over a product's image.
 
-- :guilabel:`Add to Cart`: adds a button to **add the product to the cart**;
+- :guilabel:`Add to Cart`: adds a button to
+  :doc:`add the product to the cart <../checkout_payment_shipping/cart>`;
 - :guilabel:`Comparison List`: adds a button to **compare** products based on their price, variant,
   etc.;
 - :guilabel:`Wishlist Button`: adds a button to **wishlist** the product.

content/applications/websites/ecommerce/managing_products/cross_upselling.rst

@@ -15,6 +15,9 @@ customers.
 **Upselling** is only done via :ref:`alternative products <cross_upselling/alternative>` on the
 **product page**.
 
+.. seealso::
+   :doc:`catalog`
+
 Cross-selling
 =============
 

content/applications/websites/ecommerce/managing_products/products.rst

@@ -17,6 +17,7 @@ To add a product to your catalog, you can either do it in:
   :ref:`Import records <import-data>`.
 
 .. seealso::
+   - :doc:`../managing_products/catalog`
    - :doc:`../../../sales/sales/products_prices/products/import`
    - :doc:`Product-related documentation <../../../sales/sales>`
 
@@ -66,8 +67,9 @@ In the **website builder** window, click :guilabel:`Customize` to enable additio
   :doc:`variants </applications/sales/sales/products_prices/products/variants>` of the product as a
   :guilabel:`Products List`; :guilabel:`Options` as selectable options to compose the variant
   yourself;
-- :guilabel:`Cart`: :guilabel:`Buy Now` adds a checkout button taking the customer directly to the
-  checkout page; :guilabel:`Wishlist` allows to add the product to a wishlist;
+- :guilabel:`Cart`: :guilabel:`Buy Now` adds a :ref:`checkout button <cart/buy-now>` taking the
+  customer directly to the checkout page; :guilabel:`Wishlist` allows to add the product to a
+  wishlist;
 - :guilabel:`Specification`: allows you to select where the :guilabel:`Specifications` section is
   displayed. This option displays a list of all variant attributes and values of a product, but only
   works for products *with* variants.
@@ -233,7 +235,8 @@ products:
   threshold on the product page. The available quantity is calculated based on the 'On hand'
   quantity minus the quantity already reserved for outgoing transfers.
 
-.. todo:: add ref to cart.rst about preventing sale if price = 0
+.. seealso::
+   :ref:`Allow only selected customers to buy <cart/prevent-sale>`
 
 Selling as kit
 --------------
@@ -258,8 +261,8 @@ On the product page, scroll down to the :guilabel:`Specifications` section and c
 summary.
 
 .. note::
-   The :guilabel:`Product Comparison Tool` can only be used if **attributes** are set on the
-   **product's template**.
+   The :guilabel:`Product Comparison Tool` can only be used if :doc:`attributes <variants>` are set
+   on the **product's template**.
 
 .. image:: products/products-compare.png
    :align: center

content/applications/websites/ecommerce/managing_products/variants.rst

@@ -11,6 +11,7 @@ To use product variants, enable them under :menuselection:`Website --> Configura
 in the :guilabel:`Shop - Products` section.
 
 .. seealso::
+   - :doc:`../managing_products/products`
    - :doc:`../../../sales/sales/products_prices/products/variants`
    - :doc:`../../../sales/sales/products_prices/products/import`
 
@@ -74,7 +75,7 @@ Filter catalog by attributes
 ============================
 
 Customers **can** filter the **catalog** based on product attributes and values, allowing them to
-filter the catalog based only on the attribute(s) of their choice.
+:ref:`filter <ecommerce-browsing>` the catalog based only on the attribute(s) of their choice.
 
 To enable **attributes filtering**, go to :menuselection:`Edit --> Customize` from your **main shop
 page** and click on one of the :guilabel:`Categories` in the left column. Here, enable either