Merge pull request #1039 from kartoza/Documentation-change-password-o…

…n-first-login

Documentation change password on first login

docs/src/user/guide/register-login-logout.md

@@ -76,6 +76,46 @@ On the login page fill the email address and the password in the 1️⃣ corresp
 
 On successful login you will be redirected to the home page of the miniSASS.
 
+## Why Am I Seeing the Profile Update Popup?
+
+The profile update popup appears for users under specific circumstances to ensure the security and accuracy of their account information. This guide aims to clarify why you might encounter this popup and how to address the required updates.
+
+**Reasons for Seeing the Profile Update Popup:** You are seeing the profile update popup for one of the following reasons:
+
+**First Name Set to Anonymous:**
+
+If your account's first name is currently set to "Anonymous," the system prompts you to update your profile upon login. This helps personalise your account and ensures accurate attribution of your observations within the platform.
+
+Click on the 1️⃣ `Update` button for the update profile option.
+
+![Update button](./img/register-login-logout-9.png)
+
+Upon clicking on the `Update` button, the update password form will open, along with other options. You can click on the 1️⃣ `PROFILE` option, to navigate to the update profile page. 
+
+![Update password](./img/register-login-logout-11.png)
+
+Here, you can fill in your first name in the 1️⃣ `Name` field and save the changes to avoid encountering the popup upon subsequent logins.
+
+![Profile form](./img/register-login-logout-10.png)
+
+**Password Security Constraints:**
+
+If your password does not meet the updated security constraints implemented by the site, you will be prompted to update your password when logging in. This is crucial for enhancing the security of your account and protecting your data from potential threats.
+
+Click on the 1️⃣ `Update` button, to update your password.
+
+![Update button](./img/register-login-logout-9.png)
+
+To avoid encountering the popup upon logging in, update your password according to the provided instructions. ensure your password meets the following criteria:
+
+    - Include at least one uppercase letter.
+    - Include at least one lowercase letter.
+    - Include at least one digit.
+    - Include at least one special character.
+    - Ensure the password is at least 6 characters long.
+
+![Update password](./img/register-login-logout-12.png)
+
 ## How do I logout?
 
 Logging out of your miniSASS account is a straightforward process. Follow these simple steps to ensure a secure logout.

docs/src/user/manual/landing-page.md

@@ -99,6 +99,8 @@ Ready to explore the health of the local river? Grab the collection kit, follow
 
 3. **Details**: The details section provides information about the observation uploader's username, organisation name, and the date of upload for a more detailed insight.
 
+    >NOTE: The MiniSASS prioritises user privacy by refraining from displaying users' details publicly. Instead of exposing personal information, the system ensures that only the user's first name, as per their profile form, is visible to others. In cases where users opt not to provide a first name, the system defaults to displaying "Anonymous," safeguarding their identity while maintaining a level of anonymity.
+
 - For detailed recent observation instructions, refer to the [recent observation documentation](./map/recent-observation.md).
 
 4. **View Details**: Click on the `View Details` link to access comprehensive information about the observation.
@@ -193,6 +195,38 @@ Ready to explore the health of the local river? Grab the collection kit, follow
 
 ## Landing Page After Login
 
+![Profile Update and Password Security Prompt](./img/landing-page-26.png)
+
+**Profile Update and Password Security Prompt:** Upon logging into the platform, users may encounter a profile update prompt or a password security prompt, depending on their account status. These prompts are designed to enhance user experience, ensure account security, and maintain the integrity of the platform.
+
+**Profile Update Required**
+
+    - Users who see the profile update required popup are those whose first name is currently set to `Anonymous` in their profile settings.
+
+    - The platform encourages users to personalise their accounts by updating their first name to reflect their actual identity.
+
+    - This initiative aims to foster a more engaging and personalised user experience while promoting transparency and authenticity within the community.
+
+**Password Security Prompt**
+
+    - Users may also encounter a popup if their current password does not meet the updated security constraints implemented by the platform.
+
+    - Users are prompted to update their password to comply with the new security standards, which may include requirements such as minimum character length, special character usage, and periodic password updates.
+
+    - By ensuring that all passwords adhere to the latest security protocols, the platform mitigates the risk of unauthorised access and unauthorised data breaches.
+
+    - Users are guided through the password update process, where they can securely create a new password that meets the specified criteria, thus reinforcing the overall security posture of the platform.
+
+1. **Update Button** Click on the `Update` button to proceed with updating either your password or providing your first name. 
+
+![Update password form](./img/landing-page-27.png)
+
+Upon clicking, the user will be directed to the update password form. If the user's password is deemed weak, they will be prompted to set a strong password. 
+
+![Update profile form](./img/landing-page-28.png)
+
+However, if the user's password is already strong, they can opt to click on the profile option to provide their first name.
+
 ![miniSASS Landing Page](./img/landing-page-21.png)
 
 1. **Home**: Navigate to the home page by clicking on the `Home` link.