[IMP] inventory: thd batch updates

[StraubCreative]

Overview

This is a batch cherry pick of PR’s #2002, #1984, #1900, #1876, #1870, #1854, and #1824
I took the changes originally proposed in these PR’s and stacked them here on a fresh 15.0 base since they were all merge requests into 15.0.

Formatting updates

On top of the original changes proposed by @thomasdeleval, I went ahead and updated technicals for each affected RST file + associated images. Those changes are as follows in order to bring each doc up to standards:

• fixed 100th character line breaks
• added alt text to images with proper grammar
• fixed indentations on RST tags
• renamed images attached to respective RST files (when appropriate) to match new convention (usage_01.png —> uom-handling-vs-purchase.png), and updated RST links accordingly.
• fixed some broken links + misnamed folders

Follow up items for review

I did not change any of the content other than what what the PRs originally suggested, however I think there are a number of improvements to be made around wording, grammar, and specificity of language.

Generally speaking, please consider the following suggestions in content review stage:

• add missing :guilabel:'s 😈
• wording/grammar: I caught a number of instances where the technical details were too wordy, vague, or the instruction got lost / wasn’t clear. Some words are strange like “hit” instead of “click” or “choose”.
• headings: especially the h1 so they follow convention re:guidelines:headings
• Consider rephrasing all hypothetical narratives (e.g. “imagine if…”). Would stick to third-person instructional w/ time order language, if possible. “What if” scenarios are more helpful when visually illustrated with video or long-form blog articles, however for software documentation, this will interrupt ability to skim and absorb instructions which are supposed to be clear and easy to find.
• Similarly, would also reword/remove all first-person and second-person familiar statements and stick with third-person instructional.
• images: check all for HD resolution, at or around 768 pixel breakpoint in width, and are compressed. Are there any images that need to be reshot?
• images: are they actually showcasing the feature being written about? Some aren’t clear.
• remove unnecessary images, or surround them with new blocks of descriptive copy so the writing is leading the document instead of the visuals re: guidlines:images

[robodoo]

Pull request status dashboard.

[mivu-odoo]

Finished reviewing content in wave_transfers.rst, will need to come back another time to review content in the other changed RST files.

For wave_transfers.rst, I fixed the wording to remove use of familiar second-person "you", added transition words and phrases to improve readability, fixed spelling and grammar issues, took new screenshots because the current images are wider than tablet breakpoint size, and left comments for which images can be removed.

[mivu-odoo]

Finished review for count_products.rst

Lots of images were too wide, so I took new screenshots and linked them in my comments. I also think some images aren't necessary and should be deleted, because they are redundant or they show very simple and basic things that are easy to find.

I also fixed wording. There were some spelling errors and some sentences did not make sense. I also added transition words to help the flow of the doc and show chronological order.

[mivu-odoo]

Finished review on cycle_counts.rst

A short and sweet one. Rewrote some sentences for better flow and clarity. Replaced one image inventory-frequency.png that was way too wide.

[mivu-odoo]

Finished review of strategies.rst

This was a hefty one with a lot of spelling errors.

[mivu-odoo]

Finished reviewing uom.rst

I found a lot of images were not needed b/c they were redundant and showed very obvious things that should be clear from the text. Other than that, I also fixed headers to be in sentence case and removed uses of familiar second-person pronouns like you, your, etc.

[mivu-odoo]

Fixed wording, formatting, and grammar issues. Some images for units of measure aren't needed. It's overkill when we could just link to the uom.rst in a See Also section at the end.

[mivu-odoo]

Finished reviewing integrating_landed_costs.rst, had to remove uses of second-person pronouns and rewrite sections for better flow. One question for @thomasdeleval on where to view the landed cost accounting journal entry: #2556 (comment). The sentence is unclear.

[mivu-odoo]

Finished reviewing resupply_warehouses.rst. Had to rewrite some sections for better flow and to remove uses of first and second-person pronouns.

[StraubCreative]

Hi @mivu-odoo

Latest changes on 095a938, content revisions for:

• cycle_counts.rst
• count_products.rst
• wave-transfers.rst

Also rebased to latest commit e21dbd0 and solved merge conflict for putaway.rst. Luckily there was only the one :)

At this point, @samueljlieber is going to jump in and help implement the next batch of content changes.

---

@samueljlieber, I already cleaned up the RST, and @mivu-odoo did a strong pass on most of the content. What's needed now is to implement what MIVU change requests so far, however, we still have a couple docs left to review. Also if you catch anything I missed feel free to fix as well ;)

You can get started here at this comment, and then work your way down, through each file, as far as you can.

When complete, please notify us here on progress, ty! 🙏

---

@everyone if/once the feature branch is on your computer, friendly reminder to do git pull --rebase each time before you work on it to ensure you're pulling in the latest content!

[samueljlieber]

@AntoineVDV Thank you for the suggestions! They have been implemented in f7c003b.

[AntoineVDV]

@robodoo r+