Skip to content

Conversation

@meng-odoo
Copy link
Contributor

Updated to reflect how to download Gmail Plugin from Google Workspace Marketplace for Odoo Online users; added new images

Closes Odoo Task 3001713

@meng-odoo meng-odoo requested a review from mivu-odoo September 29, 2022 22:31
@meng-odoo meng-odoo self-assigned this Sep 29, 2022
@robodoo
Copy link
Collaborator

robodoo commented Sep 29, 2022

@C3POdoo C3POdoo requested a review from a team September 29, 2022 22:33
Copy link
Contributor

@mivu-odoo mivu-odoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @meng-odoo!

Great job on your first PR! I went through it and found some edits that need to be made to remove the use of second-person pronouns (you, yours), as well sentences that could use transition words for better flow.

I also noticed two image files were quite large gh-download-zip.png and google-workspace-marketplace.png. I think they can be ran through pngquant (if you haven't already) to compress them further. I can show you how to remove the old image files and replace them with the new, compressed versions if you would like, just let me know!

When you finish the revisions, please tag me again for another look. Thank you 😸

@meng-odoo meng-odoo force-pushed the 15.0-gmail-plugin-updates-meng branch 2 times, most recently from 3a6abe3 to 45f310d Compare October 5, 2022 19:46
@meng-odoo meng-odoo requested a review from mivu-odoo October 5, 2022 19:49
Copy link
Contributor

@mivu-odoo mivu-odoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @meng-odoo!

One more round of revisions, we're almost there!

These suggestions have to do with line breaks. Some lines were broken a little too late (over 100 characters) or a little too early (under 100 characters, where more words could've fit on the line). When you're ready, tag me in for a final look. Thank you 😸

@meng-odoo meng-odoo force-pushed the 15.0-gmail-plugin-updates-meng branch from 45f310d to 8b9f164 Compare October 5, 2022 23:32
@meng-odoo meng-odoo requested a review from mivu-odoo October 5, 2022 23:37
Copy link
Contributor

@mivu-odoo mivu-odoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @meng-odoo!

Thank you for the revisions! You did a great job on this PR!

I found two small edits, so feel free to push those and then go straight to tagging ZST for final technical review, no need to tag me again. Thank you 😸

@meng-odoo meng-odoo force-pushed the 15.0-gmail-plugin-updates-meng branch from 8b9f164 to 1ca6a19 Compare October 6, 2022 21:24
@meng-odoo
Copy link
Contributor Author

Thank you @mivu-odoo!
Hi @StraubCreative, this doc is ready for your technical review. Thanks :)

Copy link
Contributor

@StraubCreative StraubCreative left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @meng-odoo 🙂
Change requests below, with instructions.
Thanks!

cc: @mivu-odoo

=================

.. _mail-plugin/gmail/enable-mail-plugin:
For databases hosted on Odoo Online (or Odoo.sh), follow the steps below to configure the Gmail
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Trailing whitespace

Suggested change
For databases hosted on Odoo Online (or Odoo.sh), follow the steps below to configure the Gmail
For databases hosted on Odoo Online (or Odoo.sh), follow the steps below to configure the Gmail

Comment on lines 73 to 74
Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show a
:guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line break before or at 100th char.

Suggested change
Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show a
:guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are
Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show
a :guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are

ensuring, for example, that no add-on redirects users toward a malicious website. (Read more on
`Google Apps Script <https://developers.google.com/apps-script/manifest/allowlist-url>`_.)

Since Odoo can only list the `odoo.com` domain and not every on-premise customer’s unique server
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use sans-serif apostrophe (not the serif version that gets c/p'd over from gdocs or similar text editors).

Suggested change
Since Odoo can only list the `odoo.com` domain and not every on-premise customers unique server
Since Odoo can only list the `odoo.com` domain and not every on-premise customer's unique server

Comment on lines 161 to 162
Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show a
:guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line break before or at 100th char

Suggested change
Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show a
:guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are
Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show
a :guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are

:alt: Allowing the Gmail Plugin to connect to a database
Finally, click :guilabel:`Allow` to let Gmail access the Odoo database. The browser will then show a
:guilabel:`Success!` message. After that, close the window. The Gmail inbox and Odoo database are
now connected.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add empty line break at end of doc

Suggested change
now connected.
now connected.

such as Notepad (Windows), TextEdit (Mac), or Visual Studio Code.

.. _mail-plugin/gmail/configure-mailbox:
Delete the following three lines of text from the :guilabel:`login` TS file:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use :file: tag here:

Suggested change
Delete the following three lines of text from the :guilabel:`login` TS file:
Delete the following three lines of text from the :file:`login.ts` file:

:align: center
:alt: Installing the Gmail Plugin from the Apps Script project
Open the ZIP file on the computer. Then, go to :menuselection:`mail-client-extensions-master -->
gmail --> src --> views`, and open the :guilabel:`login` TS file using any text editor software,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use :file: tag here:

Suggested change
gmail --> src --> views`, and open the :guilabel:`login` TS file using any text editor software,
gmail --> src --> views`, and open the :file:`login.ts` file using any text editor software,

to download the Mail Plugin files onto your computer.

#. Allow the Gmail Plugin to access some of your data.
.. image:: gmail/gh-download-zip.png
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unresolving. This file is still too big.


Install the Gmail Plugin
------------------------
.. image:: gmail/google-workspace-marketplace.png
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unresolving. This image is still too big.


Install the Gmail Plugin
------------------------
.. image:: gmail/gmail-side-panel.png
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This image is too big.

  • Capture screenshot in HD (browser at ~1280x600px with ~120% zoom)
  • Resize file to tablet/low-res desktop breakpoint b/w 768 and ~1024px (lowest you can go without having to squint at the content).
  • Compress file using pngquant
  • Replace file locally using git rm and git add

@meng-odoo meng-odoo force-pushed the 15.0-gmail-plugin-updates-meng branch 2 times, most recently from c735f56 to e01e6ce Compare December 1, 2022 21:28
@meng-odoo
Copy link
Contributor Author

Hi @StraubCreative, I made all your requested changes. I'm still getting a failed code check that says "trailing whitespace" but I double checked every line and I don't see it. Please let me know if I should make any more changes. Thanks!

@StraubCreative StraubCreative force-pushed the 15.0-gmail-plugin-updates-meng branch from e01e6ce to 4625793 Compare December 5, 2022 18:21
Copy link
Contributor

@StraubCreative StraubCreative left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for making all of the changes @meng-odoo, nice job 👍
Everything looks good to me.

I combed for whitespaces and did another rebase on 4625793, but still couldn't the issue the CI check error, so I'm going to push to DR and maybe they can help.

@StraubCreative
Copy link
Contributor

Hi @odoo/doc-review 👋
This PR is ready for review.
Please advise we couldn't find the trailing whitespace the CI check claimed was there.
We combed it twice and rebased twice as well. Can you help? TIA 🙏

@StraubCreative StraubCreative requested a review from a team December 5, 2022 18:32
Updated to reflect how to download Gmail Plugin from Google Workspace Marketplace for Odoo Online users; added new images

Closes Odoo Task 3001713
@Feyensv Feyensv force-pushed the 15.0-gmail-plugin-updates-meng branch from 4625793 to f8ea2cb Compare December 6, 2022 11:12
@Feyensv
Copy link
Collaborator

Feyensv commented Dec 6, 2022

Hi @odoo/doc-review wave This PR is ready for review. Please advise we couldn't find the trailing whitespace the CI check claimed was there. We combed it twice and rebased twice as well. Can you help?

It means that there was some empty spaces left in your changes, though it's difficult to see unless you have a dedicated extension in your text editor:
image

I've removed those empty spaces and pushed an updated commit.

Note that the CI check was supposed to give the correct line where the linting error was found, which wasn't the case here, it only showed 8 instead of 88, we'll see with the runbot team to make sure it's correctly shown in the future ;).

Copy link
Collaborator

@Feyensv Feyensv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

robodoo pushed a commit that referenced this pull request Dec 6, 2022
Updated to reflect how to download Gmail Plugin from Google Workspace Marketplace for Odoo Online users; added new images

Closes Odoo Task 3001713

closes #2773

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
@robodoo robodoo temporarily deployed to merge December 6, 2022 14:02 Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants