odoo / odoo/documentation

Enhancements to the Chapter 6 of the Module tutorial

Open
#14,990 0 comments 0 reactions 1 assignee View on GitHub

@AntoineVDV is already working on this.

Since Oct 24, 2025.

Dominant language
reStructuredText
Stars
1.3k
Forks
12.1k
PR merge metrics
No merged PRs in 30d

Description

Exercise states:
Image

But it's not exactly clear how to go from previous

<field name="view_mode">list,form</field>

to the one in Example:

<field name="arch" type="xml">
            <list string="Channel" editable="bottom">
                <field name="name"/>
            </list>
</field>

(shall view_mode be removed? Or must it be given xml type? and if the latter - what to do with the form? (I know that Form is described later, but a hint here would be welcome)

Both warnings:
Image

could be moved above the Exercise.

The:
<notebook>
    <page string="Description">
        <field name="description"/>
    </page>
</notebook>

is missing group:

<notebook>
    <page string="Description">
        <group>
            <field name="description"/>
        </group>
    </page>
</notebook>

without it it looks like this:

Image

instead of this:

Image
The
--dev xml

was giving me

odoo [--addons-path=PATH,...] server: error: no such option: --dev xml

in logs.

I had to use

--dev=xml

or in docker-compose.yml

command: ["--dev=xml"]

Maybe because I'm using docker. Or maybe because = is for Odoo 19? IDK.
Also - it would save us a lot of time if that was mentioned at the beginning of chapter 6 (not at the end)

Group By

explaination here:

Image

is also not very clear regarding group by

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.