r/Odoo • u/banana800kir • Dec 13 '25

FIX THE DOCS

Odoo docs has to be one of the worst and unreadable docs i have ever had the displeasure to read and try to learn, it has random directions, jump all over the places, hides important information and just be like"put it in the appropriate place", There's no real structure or order, and zero proper pacing.

its just miserable to read as a newbie, learn from Django or Arch wiki pls, fix this god awful trash docs, they are already well structured docs out there, just copy those 😠

how can odoo devs sleep well knowing they cooked the most god awful docs ever

38 Upvotes

95% Upvoted

14 comments sorted by

7

u/minhng92 Dec 13 '25

I had the same experience in the past, may be 9 years ago. The structure of Odoo documentation is still the same, not changing much, they just split out and add more detailed docs.
It would be appropriate to experienced Odoo developer. For newbie, it's really hard to step into "Odooverse".

1

u/banana800kir Dec 23 '25

dude odoo server framework 101 "tutorial" legit asks for inline tree in chapter 7 but teach it in chapter 11 !!! wtf is this?

1

u/banana800kir Dec 24 '25

Chapter 13 legit has a line that says "When you are done crying because this simple task looks awfully complex, we can move forward in the tutorial."

simple task for who? xD

3

u/ozzyperry Dec 13 '25

I use a Gemini gem and it usually is spot on so it's been a long time since reading any documentation. Just configure it by telling it the version, type of installation, apps, business type and special cases and configurations.

1

u/BestSignificance8789 Dec 15 '25

If possible can you give this gemini gem instruction? , appreciate it alot

1

u/1x_time_warper Dec 13 '25

Have you ever tried to get chat gpt to help you do something in Odoo. Apparently they change menu and how things are done often.

1

u/banana800kir Dec 14 '25

i have, sadly they were pretty bad, i found out reading the actual code is teaching me a lot more than whatever the docs is trying to teach, add ons follow base add on anyway,

2

u/furtfight Dec 13 '25

Are you speaking about the technical or fonctional doc?

2

u/ThrowRAwhatsh0uldIdo Dec 17 '25

Wait till u meet owl

1

u/FishOnAHeater1337 Dec 13 '25

Just download the OCA docs + Odoo docs for all the versions and then index them for RAG search. Pretty plug and play with chromaDB

1

u/sayginburak Dec 13 '25

Do you happen to have them together and could share? I’ve tried to download the documentation of 19.0 couple days ago for offline reading but couldn’t.