[IMP] Recruitment: updating images and instructions for 17 #7869

larm-odoo · 2024-02-23T22:27:32Z

Need to update the doc to reflect the changes made in 17

robodoo · 2024-02-23T22:28:24Z

larm-odoo · 2024-02-28T19:37:07Z

Hey @hojo-odoo, I don't think I've had a review form you in a long time, so I am tagging you for my peer review. Thank you!

StraubCreative · 2024-03-29T00:05:11Z

Fresh rebase on 89edc58 to rebuild the runbot instance 👍

EDIT:
Fixed failing CI error on dccd8c2, line 121, which referenced old IAP doc location before it was moved to the essentials directory.

StraubCreative

Hi @larm-odoo

Here's my first round of peer review, to get you started!

As always, your documentation is so detailed and really impressive 🙂 Please see my comments for you below for you to consider, as they mostly have to do with the content itself and perhaps expanding UI coverage in some spots. You'll notice a few writing-specific comments as well, where I caught them (however I leave the majority of those suggestions up to Final Review 😉).

Please let me know if you have any questions on this batch.
I'll add more comments soon!

content/applications/hr/recruitment.rst

StraubCreative

Hi @larm-odoo
Thorough as always!
I just had some high-level stuff for you to consider here. Feel free to apply what you agree with and then you can tag SALI or me again for a tech review (whoever can get to it first).
Thanks for the great work here!

content/applications/hr/recruitment.rst

Co-authored-by: StraubCreative <zst@odoo.com>

larm-odoo · 2024-05-14T21:54:43Z

This is ready for a tech review when you have a chance, @samueljlieber! If you are busy, @StraubCreative can do it. Whoever gets to it first, really. =)

samueljlieber

Hi @larm-odoo! Thanks for your thorough improvements to the Recruitment doc! I am approving with some comments, please let me know if you have any questions! Thank you for your hard work 😊
...
@robodoo delegate=larm-odoo

samueljlieber · 2024-05-15T14:59:16Z

content/applications/hr/recruitment.rst

+To view and edit the settings, navigate to :menuselection:`Recruitment app --> Settings`. After any
+changes are made, click the :guilabel:`Save` button in the top-left corner to save all the changes.


Missing menu step :)

Suggested change

To view and edit the settings, navigate to :menuselection:`Recruitment app --> Settings`. After any

changes are made, click the :guilabel:`Save` button in the top-left corner to save all the changes.

To view and edit the settings, navigate to :menuselection:`Recruitment app --> Configuration -->

Settings`. After any changes are made, click the :guilabel:`Save` button in the top-left corner to

save all the changes.

samueljlieber · 2024-05-15T15:03:27Z

content/applications/hr/recruitment.rst

+Posting` option.
+
+.. note::
+   The :guilabel:`Online Posting` only works if the *Website* application is also installed.


Only works, or is only available if..?

Suggested change

The :guilabel:`Online Posting` only works if the *Website* application is also installed.

The :guilabel:`Online Posting` is only available if the *Website* application is also installed.

samueljlieber · 2024-05-15T15:04:45Z

content/applications/hr/recruitment.rst

+This section of the settings page specifies what the database can and cannot do during the
+recruitment process.


Avoid "this"

Suggested change

This section of the settings page specifies what the database can and cannot do during the

recruitment process.

The :guilabel:`Recruitment process` section of the settings page specifies what the database can and

cannot do during the recruitment process.

samueljlieber · 2024-05-15T15:07:54Z

content/applications/hr/recruitment.rst

+*Recruitment* app. If no surveys have been created, the surveys list displays a `No Survey Found`
+message, and presents options to create a survey from several pre-configured survey templates.


Text displayed on the active UI should have a :guilabel:

Suggested change

*Recruitment* app. If no surveys have been created, the surveys list displays a `No Survey Found`

message, and presents options to create a survey from several pre-configured survey templates.

*Recruitment* app. If no surveys have been created, the surveys list displays a :guilabel:`No Survey

Found` message, and presents options to create a survey from several pre-configured survey

templates.

samueljlieber · 2024-05-15T15:11:03Z

content/applications/hr/recruitment.rst

+
+.. seealso::
+   For more detailed information about surveys, refer to the :doc:`survey essentials
+   </applications/marketing/surveys/create>` documentation.


Please use relative paths :)

Suggested change

</applications/marketing/surveys/create>` documentation.

<../marketing/surveys/create>` documentation.

samueljlieber · 2024-05-15T16:00:31Z

content/applications/hr/recruitment.rst

+ways, using either the :ref:`Quick add <recruitment/quick-add-applicant>` icon or the :ref:`New
+<recruitment/create-new-applicant>` button.


There is no text on the UI stating "Quick add", so you can leave it lowercase and state it is a button, whereas the icon is the + sign

Suggested change

ways, using either the :ref:`Quick add <recruitment/quick-add-applicant>` icon or the :ref:`New

<recruitment/create-new-applicant>` button.

ways, using either the :ref:`quick add <recruitment/quick-add-applicant>` button or the :ref:`New

<recruitment/create-new-applicant>` button.

samueljlieber · 2024-05-15T16:03:29Z

content/applications/hr/recruitment.rst

-:ref:`Create <recruitment/create-new-applicant>` button.
+job online) an applicant card can be easily added from the job position Kanban view in one of two
+ways, using either the :ref:`Quick add <recruitment/quick-add-applicant>` icon or the :ref:`New
+<recruitment/create-new-applicant>` button.

 .. _recruitment/quick-add-applicant:

 Quick add
 *********

 Quickly add a new applicant using the :guilabel:`Quick add` icon. If not already in the job position


Suggested change

Quickly add a new applicant using the :guilabel:`Quick add` icon. If not already in the job position

Quickly add a new applicant using the *quick add* button. If not already in the job position Kanban

samueljlieber · 2024-05-15T16:03:40Z

content/applications/hr/recruitment.rst

+Kanban view, navigate to the main recruitment dashboard by going to :menuselection:`Recruitment app
+--> Applications --> By Job Positions`. Click the :guilabel:`(#) New Applications` button on the job
+position card that the applicant should be added to. Then, click on the small :guilabel:`+ (plus
+sign) Quick add` icon in the top-right of the :guilabel:`New` stage to quickly add a new applicant.


Suggested change

Kanban view, navigate to the main recruitment dashboard by going to :menuselection:`Recruitment app

--> Applications --> By Job Positions`. Click the :guilabel:`(#) New Applications` button on the job

position card that the applicant should be added to. Then, click on the small :guilabel:`+ (plus

sign) Quick add` icon in the top-right of the :guilabel:`New` stage to quickly add a new applicant.

view, navigate to the main recruitment dashboard by going to :menuselection:`Recruitment app -->

Applications --> By Job Positions`. Click the :guilabel:`(#) New Applications` button on the job

position card that the applicant should be added to. Then, click on the small :icon:`fa-plus`

:guilabel:`(plus)` icon in the top-right of the :guilabel:`New` stage to quickly add a new

applicant.

samueljlieber · 2024-05-15T16:05:49Z

content/applications/hr/recruitment.rst

+Add a new applicant including all the relevant information using the :guilabel:`New` button. If not
+already in the Kanban view for the job position to add an applicant to, navigate to the main
+recruitment dashboard by going to :menuselection:`Recruitment app --> Applications --> By Job
+Positions`. Then, click the :guilabel:`New` button in the top-left of the Kanban view and a blank
+applicant form loads.


Suggested change

Add a new applicant including all the relevant information using the :guilabel:`New` button. If not

already in the Kanban view for the job position to add an applicant to, navigate to the main

recruitment dashboard by going to :menuselection:`Recruitment app --> Applications --> By Job

Positions`. Then, click the :guilabel:`New` button in the top-left of the Kanban view and a blank

applicant form loads.

Add a new applicant including all the relevant information using the *New* button. If not already in

the Kanban view for the job position to add an applicant to, navigate to the main recruitment

dashboard by going to :menuselection:`Recruitment app --> Applications --> By Job Positions`. Then,

click the :guilabel:`New` button in the top-left of the Kanban view and a blank applicant form

loads.

samueljlieber · 2024-05-15T16:18:17Z

content/applications/hr/recruitment.rst

+a red box at the bottom of the :guilabel:`Generate a Simulation Link` pop-up window, stating `The
+applicant does not have a valid email set. The Offer Link won't be able to be completed.` Click
+:guilabel:`Discard`, enter an email on the applicant's card, then click the :guilabel:`Generate
+Offer` button again.


Use guilabel for text displayed on the UI

Suggested change

a red box at the bottom of the :guilabel:`Generate a Simulation Link` pop-up window, stating `The

applicant does not have a valid email set. The Offer Link won't be able to be completed.` Click

:guilabel:`Discard`, enter an email on the applicant's card, then click the :guilabel:`Generate

Offer` button again.

a red box at the bottom of the :guilabel:`Generate a Simulation Link` pop-up window, stating

:guilabel:`The applicant does not have a valid email set. The Offer Link won't be able to be

completed.` Click :guilabel:`Discard`, enter an email on the applicant's card, then click the

:guilabel:`Generate Offer` button again.

larm-odoo marked this pull request as draft February 23, 2024 22:27

larm-odoo force-pushed the 17.0-recruitment-updating-config-and-flow-larm branch from 8456c8e to 2766f3a Compare February 28, 2024 18:37

larm-odoo marked this pull request as ready for review February 28, 2024 18:38

larm-odoo requested a review from jero-odoo February 28, 2024 18:38

C3POdoo requested a review from a team February 28, 2024 18:38

larm-odoo force-pushed the 17.0-recruitment-updating-config-and-flow-larm branch from 2766f3a to 5f31474 Compare February 28, 2024 19:35

larm-odoo requested review from hojo-odoo and removed request for jero-odoo February 28, 2024 19:35

larm-odoo self-assigned this Mar 20, 2024

StraubCreative requested review from StraubCreative and removed request for hojo-odoo March 29, 2024 00:02

StraubCreative force-pushed the 17.0-recruitment-updating-config-and-flow-larm branch from 5f31474 to 89edc58 Compare March 29, 2024 00:04

StraubCreative force-pushed the 17.0-recruitment-updating-config-and-flow-larm branch from 89edc58 to dccd8c2 Compare March 29, 2024 00:13

StraubCreative reviewed Mar 29, 2024

View reviewed changes

larm-odoo force-pushed the 17.0-recruitment-updating-config-and-flow-larm branch from dccd8c2 to d943921 Compare March 29, 2024 20:31

StraubCreative force-pushed the 17.0-recruitment-updating-config-and-flow-larm branch from d943921 to b7d3557 Compare May 13, 2024 19:42

StraubCreative approved these changes May 13, 2024

View reviewed changes

StraubCreative added the 3 label May 13, 2024

[IMP] Recruitment: instructions and images for 17

e346177

Co-authored-by: StraubCreative <zst@odoo.com>

larm-odoo force-pushed the 17.0-recruitment-updating-config-and-flow-larm branch from b7d3557 to e346177 Compare May 14, 2024 21:53

larm-odoo requested a review from a team May 14, 2024 21:53

samueljlieber approved these changes May 15, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[IMP] Recruitment: updating images and instructions for 17 #7869

[IMP] Recruitment: updating images and instructions for 17 #7869

larm-odoo commented Feb 23, 2024

robodoo commented Feb 23, 2024

larm-odoo commented Feb 28, 2024

StraubCreative commented Mar 29, 2024 •

edited

StraubCreative left a comment

StraubCreative left a comment

larm-odoo commented May 14, 2024

samueljlieber left a comment

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

samueljlieber May 15, 2024

		To view and edit the settings, navigate to :menuselection:`Recruitment app --> Settings`. After any
		changes are made, click the :guilabel:`Save` button in the top-left corner to save all the changes.

	The :guilabel:`Online Posting` only works if the Website application is also installed.
	The :guilabel:`Online Posting` is only available if the Website application is also installed.

		This section of the settings page specifies what the database can and cannot do during the
		recruitment process.

		Recruitment app. If no surveys have been created, the surveys list displays a `No Survey Found`
		message, and presents options to create a survey from several pre-configured survey templates.

	</applications/marketing/surveys/create>` documentation.
	<../marketing/surveys/create>` documentation.

		ways, using either the :ref:`Quick add <recruitment/quick-add-applicant>` icon or the :ref:`New
		<recruitment/create-new-applicant>` button.

	Quickly add a new applicant using the :guilabel:`Quick add` icon. If not already in the job position
	Quickly add a new applicant using the quick add button. If not already in the job position Kanban

[IMP] Recruitment: updating images and instructions for 17 #7869

Are you sure you want to change the base?

[IMP] Recruitment: updating images and instructions for 17 #7869

Conversation

larm-odoo commented Feb 23, 2024

robodoo commented Feb 23, 2024

larm-odoo commented Feb 28, 2024

StraubCreative commented Mar 29, 2024 • edited

StraubCreative left a comment

Choose a reason for hiding this comment

StraubCreative left a comment

Choose a reason for hiding this comment

larm-odoo commented May 14, 2024

samueljlieber left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

StraubCreative commented Mar 29, 2024 •

edited