many registration process updates and other articles (sws2apps#365)

Author: ux-git

organized/docs/faq/security.md

@@ -67,12 +67,22 @@ When you choose to use our Organized app, we only collect essential information
 
 ## Can I run the Organized without my own server and database?
 
-We are currently working on this. With the next updates, you will be able to run Organized on your own server with your own database, giving you uncompromised control over all data and access. 
+We are currently working on this. With future updates, you will be able to run Organized on your own server with your own database, giving you uncompromised control over all data and access. 
 
 ## Where my Organized data is stored?
 
 Your data is stored securely in Organized, depending on how you use the app. 
 
 - If you're using the app alone on a single device, your data is stored only locally on that device. 
 
-- If you're using the app with your congregation or on multiple devices, your data is still **stored on your device**, but data backups are also regularly shared with other members of your congregation _(only the data allowed them to view, such as schedules, persons, groups, etc.)_. All the data backups are encrypted using your own strong encryption code and securely shared across congregation members through our servers. All data is stored with the highest level of security, and no one unauthorized can access or read it.
+- If you're using the app with your congregation or on multiple devices, your data is still **stored on your device**, but data backups are also regularly shared with other members of your congregation _(only the data allowed them to view, such as schedules, persons, groups, etc.)_. All the data backups are encrypted using your own strong encryption code and securely shared across congregation members through our servers. All data is stored with the highest level of security, and no one unauthorized can access or read it.
+
+## What is the difference between the Congregation master key and Congregation access code?
+
+Both the Congregation master key and the Congregation access code serve to protect your congregation’s data through end-to-end encryption, but they differ in their access levels and purposes:
+
+- **Access code:** This code is used by *everyone* who wants to join your congregation in the Organized app and when logging in on new devices. It’s the final step in the registration process, confirming that the person has been authorized by the congregation's elders. However, possessing the access code alone doesn't grant full access — administrators still have to manage and adjust user role(s) and permissions after they join. The Congregation access code should be relatively user-friendly, meaning it should be easy to enter multiple times by different age groups in the congregation, featuring a thoughtful mix of words and numbers. It’s important to avoid using obvious or commonly known phrases to maintain security. This balance ensures that while the code is accessible for legitimate users, it remains secure against unauthorized access.
+
+- **Master key:** This code provides a higher level of access, required by those who handle significant congregation data, such as scheduling, reporting and managing the congregation account. The master key is more secure, longer, and complex, and it's known only to a select few trustworthy brothers who are responsible for the congregation’s administrative tasks.
+
+In summary, while the access code allows users to join the congregation and view the basic information about meetings and other congregation activities, the master key safeguards the administrative functions, ensuring that only authorized individuals can perform administrative tasks.

organized/docs/how-to-use/congregation/img/brother-start.png

@@ -19,43 +19,45 @@ Click "Add new user" button on the "Manage access to Organized" page. Then, foll
 To add a baptized brother to your congregation, he should already have an account registered in Organized. Once he has registered, you can search for his account by email address and add his to your congregation.
 
 1. Select the corresponding **"Baptized brother"** option.
+![Publisher option](./img/brother-start.png)
 2. Ask a baptized brother for the email address he used to register in Organized.
-
-![Select option](./img/brother-start.png)
-
 3. Use this email to add him to your congregation.
 
-:::tip[If you see "No user found with this email address":]
+:::info[If you see "No user found with this email address":]
 Ensure you enter the correct email address without typos and that the brother has indeed created an Organized account and sees the "Thanks for registering" message in the Organized app.
 :::
-![No user found with this email address](./img/brother-error.png)
 
 4. Once you enter a correct email address that already exists on Organized, the email field will be highlighted with green saying _"User found! Create user and set up his profile and rights"_.
+5. Click "Create user" button and then his user record will be added.
 
 ![Brother account found](./img/brother-found.png)
 
-5. Click "Create user" button and then his user record will be added.
-
 ## Publisher or midweek student
 
 To bind a user profile with a person record from your congregation, ensure that you have already added this brother or sister to the congregation's [Persons page](../how-to-use/persons/all-persons).
 
 1. Select the corresponding **"Publisher or midweek student"** option.
-2. Select a person record from the list. Make sure that the person record already exists on the [Persons page](../how-to-use/persons/all-persons.md) so that you can find it.
 
 ![Publisher option](./img/publisher-start.png)
 
+2. Select a person record from the list. Make sure that the person record already exists on the [Persons page](../how-to-use/persons/all-persons.md) so that you can find it. 
+
+:::warning[This step is very important!]
+You **must select a person record** that matches this new user to proceed. Why is this important? Binding the new Organized user to an existing person record *(which contains name, qualitications, assignments, contant info, etc)* ensures that when they join your congregation in Organized, they can immediately view their upcoming assignments, submit their field service reports, and have their data correctly linked in congregation reports.
+:::
+
 3. After you selected the person from the list, simply click "Create user" button.
 4. Right after that, you will see the "Invite user" window with their personal unique invitation code. Provide this personal invitation code to grant them access to your congregation on Organized.
 
 ![Publisher invitation code](./img/publisher-invite-code.png)
 
 :::tip[The invitation code will always be accessible]
-Note, that this code will also be available on their user page, so no need to worry that it will disappear after you close this window. You can always access it later.
+Note, that this code will also be available on their user page, so no need to worry that it will disappear after you close this window. You can always access or regenerate it later.
 :::
 
 5. Copy the code and give this code to the user in a secure way. You can manually copy it, or use "Copy" or "Share" button to share it faster.
 6. After clicking "Done", the new user record will be added.
+7. Provide your Congregation access code to the new user so they can connect to your congregation without any issues. However, it's crucial to emphasize the importance of keeping this code confidential. Encourage users not to share it with others, even within the congregation. If someone else needs the Congregation access code, they should be directed to ask the elders or the Organized app administrator. While Organized takes many steps to keep your data secure, maintaining the confidentiality of this information is a shared responsibility.
 
 ## Well done!
 

organized/docs/how-to-use/congregation/img/publisher-start.png

@@ -4,7 +4,7 @@ sidebar_position: 4
 
 # Manage access
 
-Organized provides flexible user access management for your congregation. Access the 'Manage Access' page from the 'Congregation' home page card to view and manage all users and their roles.
+Organized provides flexible user access management for your congregation. Access the 'Manage Access' page from the 'Congregation' card on the home page to view and manage all users and their roles.
 
 ## View all users
 
@@ -18,7 +18,7 @@ User profiles are **not the same as person records**. User profiles represent re
 
 ## Add user
 
-Click the 'Add user' button and then select whether you want to add either a **Baptized brother** or a **Publisher or midweek meeting student**. Then, follow the instructions of the app to finish adding new user. For detailed step-by-step guide, read the next article: [Invite persons to your congregation](invite-persons).
+Click the 'Add user' button and then select whether you want to add either a **Baptized brother** or a **Publisher or midweek meeting student**. Then, follow the instructions of the app to finish adding new user. For detailed step-by-step guide, read the [Invite persons to your congregation](invite-persons) guide.
 
 ![Add new Organized user](./img/add-button.png)
 

organized/docs/how-to-use/congregation/invite-persons.md

@@ -6,7 +6,7 @@ sidebar_position: 2
 
 If your congregation doesn't use Organized yet, start by registering as a "Baptized brother".
 
-:::tip[Please, be aware]
+:::info[Please, be aware]
 Please, ensure elders of your congregation approve Organized app usage before proceeding.
 :::
 
@@ -16,33 +16,27 @@ After completing the registration, click on the "Create Congregation" button at
 
 ![Create a congregation](./img/create.png)
 
-## Enter details
+## Select your congregation
 
-After doing so, enter your congregation’s details in corresponding fields. Congregation name and number is fetched directly from jw.org. Make sure to write at least two characters for the search to start working. If you can't find your congregation in the search field, or it is not even listed on the jw.org congregation search page, please contact our [support email](mailto:[email protected]) for further assistance.
+Enter your personal and congregation’s details in corresponding fields. Congregation name and number is fetched directly from jw.org. Make sure to enter at least two characters for the search to start working. If you can't find your congregation in the search field, or it is not even listed on the jw.org congregation search page, please contact our [support email](mailto:[email protected]) for further assistance.
 
-![Congregation details](./img/details.png)
+### Create a Congregation master key
 
-3### Set up a Congregation master key
+This master key protects your congregation's information. It's required for anyone working with congregation data, scheduling, and managing the congregation account. Please avoid using easily guessed or common numbers and phrases, such as _1914_, _1qaz2wsx_, _144000_, _bestlifeever_ or _Organized_. The code can consist of readable words or random characters, depending on the technical proficiency and preferences of your congregation’s elders and ministerial servants who will be using the app. Consider their readiness and 'comfort level' when choosing the format.
 
-This code safeguards your congregation's info. Please avoid using widely known or obvious numbers and words like _1914_, _144000_, _bestlifeever_ or _Organized_. You can see an example of a strong code on the image below.
+Organized has many strong security features, but keeping your congregation's data safe also depends on each user being careful and responsible. By staying alert and using good practices while sharing the code with other authorized brothers, you help keep everyone's information secure.
 
-:::danger[Encryption code is very important]
-**If you lose this code, all congregation data will be lost**, and you'll need to start all over again. Note it and keep it safe! Notify brothers and sisters to not share it with others. Keeping your congregation info secure is a joint goal and responsibility of all users.
+:::danger[Master key is crucial]
+**If you lose this code, all congregation data will be lost**, and you'll need to start all over again. Note it and keep it safe! Notify others to not share it with persons, who are not authorized by your elders. Keeping your congregation info secure is a joint goal and responsibility of all users.
 :::
 
-![Congregation encryption code](./img/encryption.png)
-
-### Create a Congregation master key
-
-This master key protects your congregation's information. It's required for anyone working with congregation data, scheduling, and managing the congregation account. Please avoid using easily guessed or common numbers and phrases, such as _1914_, _144000_, _bestlifeever_ or _Organized_. You can see an example of a strong code on the image below. 
-
-Organized has strong security features, but keeping your congregation's data safe also depends on each user being careful and responsible. By staying alert and using good practices, you help keep everyone's information secure.
+#### Principles for creating a secure master key:
 
-:::danger[Encryption code is very important]
-**If you lose this code, all congregation data will be lost**, and you'll need to start all over again. Note it and keep it safe! Notify brothers and sisters to not share it with others. Keeping your congregation info secure is a joint goal and responsibility of all users.
-:::
+- **Complexity**: The master key should be longer and include a mix of letters, numbers, and special characters.
+- **Strong security**: It must be strong and difficult to guess, reflecting its critical role in securing administrative access.
+- **Confidentiality**: Only share the master key with authorized, trustworthy brothers to maintain its security.
 
-![Congregation encryption code](./img/encryption.png)
+![Congregation master key requirements](./img/master-key-requirements.png)
 
 ### Create a Congregation access code
 
@@ -52,6 +46,20 @@ Since many people in your congregation will know this code, advise new users not
 
 You can change the congregation access code in the settings later. However, remember that changing the access code means you need to notify all active users so they can later log in to their accounts without any troubles.
 
+#### Principles for creating a good access code:
+
+- **Simplicity and ease of use**: The access code should be relatively easy for users to enter but not so obvious that it becomes a security risk.
+- **Avoid widely known phrases**: Use a meaningful combination of words and numbers that are not easily guessable.
+- **Keep the code secure and users informed**: Even though the access code is easier to remember and enter, it should still be unique and not easily guessed. Remind users to not share the code personally, but always request it from Organized app administrator in your congregation.
+
 ### Your congregation is created!
 
-Done! Once everything is set up, you will land on your congregation's page as the admin. From here, you can add members, assign roles like coordinator or secretary, and grant specific rights, such as editing schedules and others. Explore other guide articles to learn how to add all required congregation details, invite users to your congergation in Organized, create schedules and so much more!
+Well done! Once everything is set up, you’ll land on your congregation’s page as the admin. From here, you can complete the initial basic congregation preferences setup, create your own person record. After that, let’s explore the app together and uncover all its features!
+
+### What to do next?
+
+It’s time to set up your congregation, including person records, new users, and meeting materials imports, to ensure everything is ready for the congregation to benefit from Organized.
+
+For you to simplify this path, we prepared the [Recommended congregation setup steps guide](../onboarding/setup-order), which you can follow to make the setup process smooth and flawless.
+
+Be sure to explore our other guide articles to discover how to fully utilize all the features and capabilities of the app!

organized/docs/how-to-use/congregation/manage-access.md

@@ -40,17 +40,17 @@ Ask your elders or the Organized administrator in your congregation for your per
 
 ![Invitation](./img/invitation.png)
 
-### Enter congregation’s encryption code
+### Enter the Congregation access code
 
-Great! The next step is entering your congregation’s encryption code. That is a code created by elders to ensure the security of the app. Please don’t share the code without direct permission from your elders.
+Great! The next step is entering your congregation’s access code. That is a code created by elders to ensure the strong security of the app. Please don’t share the code with others, but encourage them to request the code directly by elders.
 
 Click on the “Validate” button, and if the code is correct, your account will be created.
 
-![Enter encryption](./img/enter-encryption.png)
+### Notify app administrator about your new account
 
-### Notify administrator about your new account
+The account is successfully created and connected with your congregation. 
 
-The account is successfully created and connected with your congregation. The important thing left to do is to ask your congregation’s Organized administrator to adjust your account’s roles and rights. After doing so, you will be able to access the app and see the schedules and assignments. 
+The important thing left to do is to ask your congregation’s Organized administrator to adjust your account’s roles and rights. After doing so, you will be able to access the app and see the schedules and assignments. 
 
 ## Option 2: Log in as a Baptized brother
 
@@ -66,25 +66,29 @@ Click the "Baptized brother" button. This option is for all baptized brothers, i
 
 After selecting “Baptized brother” option, you will see this important message about how the Organized app works and keeps your data safe. Please read it so you understand it and even can explain it to others. Then select the checkbox below and click “Next”.
 
-
 ![Read and accept](./img/accept.png)
 
 ### Select your login method
 
 Now select how you'd like to log in to Organized. Remember your choice for next time, so you can access your existing account instead of making a new one.
 
-
 ![Log in](./img/select-login.png)
 
 **Alternative:** If you don’t have any account in Google, Microsoft, GitHub or Yahoo, you can log in with your email address. Just select “Continue with Email” option and and follow the short and simple instructions.
 
-![Email auth](./img/email-auth.png)
+### Enter the Access code
+
+Great! The next step is entering your congregation’s access code. That is a code created by elders to ensure the strong security of the app. Please don’t share the code with others, but encourage them to request the code directly by elders.
+
+### Enter the Master key
+
+If prompted, enter the Congregation master key. This key is required by those handling administrative and scheduling tasks in Organized. If you’re asked for it, contact your congregation’s Organized administrator to obtain the Master key. Always keep it secure and confidential, as it is crucial for your congregation's Organized account!
 
 ### Request adjustments of your rights
 
-Well done! Your “Baptized brother” account is now created! You just need to:
+Well done! Your 'Baptized brother' account is now created! You just need to:
 1. Inform your congregation’s Organized administrator
 2. Provide him your email address that you used for account registration
 3. Wait until he assigns you all the necessarry roles and rights.
 
-#### Afterward, so you can open the Organized app and start using it.
+#### Afterward, so you can open the Organized app and start using it!