[ADD] fleet: create new vehicles

[larm-odoo]

Adding a new document and section to HR. No fleet documentation currently exists.

[robodoo]

Pull request status dashboard.

[larm-odoo]

Waiting for some feedback/answers from Quentin so this doc can be finished- not ready for review yet.

[larm-odoo]

Hi @jcs-odoo - can you help with the codeowner issue? This is a new doc for a new app (no previous doc existed for fleet).

[jcs-odoo]

Hi @jcs-odoo - can you help with the codeowner issue? This is a new doc for a new app (no previous doc existed for fleet).

Hi @larm-odoo !

All good for the codeowner team

I haven't read the doc, but I saw the title "Add a vehicle". Usually, we try to avoid verbs in titles. --> https://www.odoo.com/documentation/master/contributing/documentation/content_guidelines.html#titles-and-headings

When we explain a record on a documentation page, it is not only to add a new record from scratch (like we explain in video tutorials, for example), but mostly to describe how it works in general, as a reference (which can be both to create a new record, view or edit an existing one).

I hope this is helpful. Have a good day :)

[larm-odoo]

Thank you @jcs-odoo - I had tagged you at the suggestion of a coworker when I got the original error, but I am glad it was a non-issue! As for the name, thank you for pointing that out, and I have updated it so it is in a better format =)

[jero-odoo]

Nice work @larm-odoo, only a few notes. Let me know if you have any questions. Thanks!

[larm-odoo]

Hi @tiku-odoo - this is set for the 2nd peer review!

[tiku-odoo]

@larm-odoo

Good start to this doc- I like the definitions you've compiled. However, I think this doc needs some intros to each section, so it isn't textbook. I've left a few comments on things to change. Notable-- it isn't the calendar module the dropdown/selector is populating. It is just a standard date selector. We should not be using the word "module." A module in Odoo is an application or set of Python instructions to be executed. All this does is select a date unless I am missing something.

Creating a company deserves a warning admonition block. This causes subscriptions to go up $$$ and potentially shut a database down if they don't resolve the upsell.

A few other questions - Are there any links with the accounting app? I see a lot of data input here.

Loop me back in for a quick review once you've made the changes. Thanks 👍
Tim

[tiku-odoo]

If this document is going to be forward ported, you can use some adaptive language-- create or new --- if required save, etc. These are small edits that could save you time in the long run.

[larm-odoo]

I see what you mean, but I think it's best to keep the docs for the specific versions, to keep things clear. I do the version specific changes, and I kind of like keeping everything very organized like that. I'll leave this for @StraubCreative to decide since it could go either way.

[tiku-odoo]

@larm-odoo -- Can you explain the copied info?

From #5763

[larm-odoo]

Hi @tiku-odoo - I addressed the things I could, and replied to a few things I wasn't 100% on. Thanks for the module explanation- that has been fixed. I didn't see any specific accounting documents I could link to- nothing really mentions vehicles or anything related to it. As for the duplicate looking sections- I see what you mean, but I did check the 2 docs and they are actually different forms but they have a LOT of overlapping entries. But they are accessed form different places and they do have different names for the forms and have different content. If you want to take a second look, it's ready!

[tiku-odoo]

Looks good Lara- still wondering about the same information in your two fleet PRs-- does one populate the other?

I think we need some clarification on whether it should populate from the model one sets up in #5763 (line 149)-- if not okay, I'm just wondering why we're instructing the user to input the same information twice.

#5763
`Model

---

• :guilabel:Seats Number: Enter how many passengers the vehicle can accommodate.
• :guilabel:Doors Number: Enter the number of doors the vehicle has.
• :guilabel:Color: Enter the color of the vehicle.
• :guilabel:Model Year: Enter the year the vehicle was manufactured.
• :guilabel:Trailer Hitch: Check this box if the vehicle has a trailer hitch installed.
• Engine

---

• :guilabel:Fuel Type: Select the type of fuel the vehicle uses form the drop-down menu. The
  options are :guilabel:Diesel, :guilabel:Gasoline, :guilabel:Hybrid Diesel, :guilabel:Hybrid Gasoline, :guilabel:Plug-in Hybrid Diesel, :guilabel:Plug-in Hybrid Gasoline,
  :guilabel:CNG, :guilabel:LPG, :guilabel:Hydrogen, or :guilabel:Electric.
• :guilabel:CO2 Emissions: Enter the average carbon dioxide emissions the vehicle produces in
  grams per kilometer (g/km). This information is provided by the car manufacturer.
• :guilabel:CO2 Standard: Enter the standard amount of carbon dioxide in grams per kilometer
  (g/km) for a similar sized vehicle.
• :guilabel:Transmission: Select the transmission type from the drop-down menu, either
  :guilabel:Manual or :guilabel:Automatic.
• :guilabel:Power: If the vehicle is electric or hybrid, enter the power the vehicle uses in
  kilowatts (kW).
• :guilabel:Horsepower: Enter the vehicle's horsepower in this field.
• :guilabel:Horsepower Taxation: Enter the amount that is taxed based on the size of the vehicles
  engine. This is determined by local taxes and regulations, and varies depending on the location.
  It is recommended to check with the accounting department to ensure this value is correct.
• :guilabel:Tax Deduction: This field auto-populates according to the engine specifications, and
  cannot be modified. The percentage is based on the localization settings and local tax laws.`

#5759

`Model

- :guilabel:`Model Year`: Enter the year the vehicle was manufactured.
- :guilabel:`Transmission`: Select the transmission type from the drop-down menu, either
  :guilabel:`Manual` or :guilabel:`Automatic`.
- :guilabel:`Color`: Enter the color of the vehicle.
- :guilabel:`Seats Number`: Enter how many passengers the vehicle can accommodate.
- :guilabel:`Doors Number`: Enter the number of doors the vehicle has.
- :guilabel:`Trailer Hitch`: Check this box if the vehicle has a trailer hitch.

Engine

• :guilabel:Horsepower: Enter the vehicle's horsepower in this field.
• :guilabel:Power: If the vehicle is electric or hybrid, enter the power the vehicle uses in
  kilowatts (kW).
• :guilabel:Fuel Type: Select the type of fuel the vehicle uses form the drop-down menu. The
  options are :guilabel:Diesel, :guilabel:Gasoline, :guilabel:Hybrid Diesel, :guilabel:Hybrid Gasoline, :guilabel:Plug-in Hybrid Diesel, :guilabel:Plug-in Hybrid Gasoline,
  :guilabel:CNG, :guilabel:LPG, :guilabel:Hydrogen, or :guilabel:Electric.
• :guilabel:CO2 Emissions: Enter the average carbon dioxide emissions the vehicle produces in
  grams per kilometer (g/km). This information should be available from the car manufacturer, or
  from the dealership the car was purchased from.
• :guilabel:Co2 Standard: Enter the standard amount of carbon dioxide for a similar sized vehicle.

.. image:: new_vehicle/new-vehicle-model.png
:align: center
:alt: The new vehicle form, showing the vehicle tax section.`

[larm-odoo]

Hi @tiku-odoo and @jero-odoo:

This note has been edited so I don't lose any of this info. This doc is referencing an anchor in the configuration doc for Fleet. The PR that must be merged before this one can, is:
[ADD] fleet: new configurations doc #5763
Once that is closed, this won't have a build error since the document will be published. Once tat happens, I'll tag you both to approve this, so this can move forward.

[jero-odoo]

great job @larm-odoo . Had a few additional notes, let me know if you have any questions. Thanks!

[samueljlieber]

Nice job @larm-odoo! This doc looks great, I only have two small corrections that I will push up after this review, please see below. Approving now, thank you!

[samueljlieber]

Italicize app names

Suggested change

	Odoo's Fleet app manages all vehicles and the accompanying documentation that comes with vehicle
	Odoo's *Fleet* app manages all vehicles and the accompanying documentation that comes with vehicle

[samueljlieber]

Suggested change

	XX.XX format. Repeat this for all entires needed.
	XX.XX format. Repeat this for all entries needed.

[samueljlieber]

Implemented technical changes in de5d382.

@StraubCreative this PR is good to go 👍 and can be FWP all the way up to master.
Just to note, we may have a conflict on the FWP for 16.0 due to the addition of a custom anchor on new_employee.rst in this PR.

[StraubCreative]

@robodoo r+

[robodoo]

@larm-odoo @StraubCreative staging failed: ci/runbot on 876654e39181f2931dfa2dbc4daf346138c5508c (view more at https://runbot.odoo.com/runbot/build/55789433)

[StraubCreative]

@robodoo retry

[fw-bot]

@larm-odoo @StraubCreative this pull request has forward-port PRs awaiting action (not merged or closed):

• [FW][ADD] fleet: create new vehicles #7204
• [FW][ADD] fleet: create new vehicles #7205

[fw-bot]

@larm-odoo @StraubCreative this pull request has forward-port PRs awaiting action (not merged or closed):

• [FW][ADD] fleet: create new vehicles #7221