7f623b6ad5
Prior to this commit, users had to either know in advance or guess the
location of the content they were looking for. Top-level pages of the
"Developer" section of the documentation, in particular the "Developer"
page itself, were listing their sub-pages without directions for users.
This commit brings the following changes to improve the navigation:
- add directions for users on the "Developer" page and list the three
main categories of developer documentation ("Tutorials", "How-to
guides", and "Reference") with explanations of their content and
target audience;
- add categories for content cards on the "Tutorials" and "How-to
guides" pages, and fine-tune the toctree of the "Reference" page to
more easily locate specific topics;
- clarify what are the "Python framework" and the "JavaScript framework"
by relabelling them to "Server framework" and "Web framework" on
top-level pages, as some users were confused to find that the JS
framework was not responsible for the server, and others that the
documentation for QWeb template is located in the Python documentation;
- extract the "Setup guide" from the "Getting started" tutorial and
rename the latter to "Server framework 101" to allow reusing the setup
guide in other tutorials and make clear that the "Server framework 101"
tutorial is not about the Web framework.
task-3802536
closes odoo/documentation#8597
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Valeriya (vchu) <vchu@odoo.com>
118 lines
5.7 KiB
HTML
118 lines
5.7 KiB
HTML
<div id="o_content">
|
|
<section class="o_content_fw_banner">
|
|
<h1 class="text-white">{{ _("Odoo Documentation") }}</h1>
|
|
</section>
|
|
<section>
|
|
<div class="row gx-lg-5">
|
|
<div class="col-lg-6">
|
|
<h2><a href="{{ pathto('applications') }}">{{ _("User Docs") }}</a></h2>
|
|
<p class="text-dark">{{ _("Discover our guide to help you use and configure the platform, by applications.") }}</p>
|
|
<h5 class="text-dark pt-3 text-uppercase fw_bold">{{ _("Top Apps") }}</h5>
|
|
<ul class="list-unstyled">
|
|
<li>
|
|
<a href="{{ pathto('applications/finance/accounting') }}" class="stretched-link">
|
|
{{ _("Accounting") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('applications/inventory_and_mrp/inventory') }}" class="stretched-link">
|
|
{{ _("Inventory") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('applications/inventory_and_mrp/manufacturing') }}" class="stretched-link">
|
|
{{ _("Manufacturing") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('applications/sales/point_of_sale') }}" class="stretched-link">
|
|
{{ _("Point of Sale") }}
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="col-lg-6">
|
|
<h2 class="border-top pt-4 pt-lg-0"><a href="{{ pathto('administration') }}">{{ _("Install and Maintain") }}</a></h2>
|
|
<p class="text-dark">{{ _("Learn how to install, deploy and upgrade Odoo on premise or on Odoo.sh.") }}</p>
|
|
<h5 class="text-dark pt-3 text-uppercase fw_bold">{{ _("Top Links") }}</h5>
|
|
<ul class="list-unstyled">
|
|
<li>
|
|
<a href=" {{ pathto('administration/deployment/install') }} " class="stretched-link">
|
|
{{ _("Installing Odoo") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('administration/maintain/update') }}" class="stretched-link">
|
|
{{ _("Bugfix updates") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('administration/upgrade') }}" class="stretched-link">
|
|
{{ _("Upgrading Odoo") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('administration/odoo_sh/overview/introduction') }}" class="stretched-link">
|
|
{{ _("Odoo.sh: The Odoo Cloud Platform") }}
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="row gx-lg-5">
|
|
<div class="col-lg-6">
|
|
<h2 class="border-top pt-4"><a href="{{ pathto('developer') }}">{{ _("Developer") }}</a></h2>
|
|
<p class="text-dark">{{ _("Learn to develop in Odoo with the developer tutorials and framework references.") }}</p>
|
|
<h5 class="text-dark pt-3 text-uppercase fw_bold">{{ _("Top Links") }}</h5>
|
|
<ul class="list-unstyled">
|
|
<li>
|
|
<a href="{{ pathto('developer/tutorials') }}" class="stretched-link">
|
|
{{ _("Tutorials") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('developer/howtos') }}" class="stretched-link">
|
|
{{ _("How-to guides") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('developer/reference') }}" class="stretched-link">
|
|
{{ _("Reference") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('developer/reference/external_api') }}" class="stretched-link">
|
|
{{ _("External API") }}
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="col-lg-6">
|
|
<h2 class="border-top pt-4"><a href="{{ pathto('contributing') }}">{{ _("Contributing") }}</a></h2>
|
|
<p class="text-dark">{{ _("You want to contribute to Odoo but don't know where to start? The tutorials and guidelines are there to help you make Odoo even better.") }}</p>
|
|
<h5 class="text-dark pt-3 text-uppercase fw_bold">{{ _("Top Links") }}</h5>
|
|
<ul class="list-unstyled">
|
|
<li>
|
|
<a href="{{ pathto('contributing/development/coding_guidelines') }}" class="stretched-link">
|
|
{{ _("Coding guidelines") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('contributing/documentation') }}" class="stretched-link">
|
|
{{ _("Documentation") }}
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="{{ pathto('contributing/documentation/content_guidelines') }}" class="stretched-link">
|
|
{{ _("Content guidelines") }}
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
{# If changelog exists import it here}
|
|
{% include "layout_templates/changelog.html" %}
|
|
{#}
|
|
</div>
|