Skip to content

Commit 8b76079

Browse files
author
Maxim Tereshko
committed
docs(naming): fixed en locale
1 parent 37223dd commit 8b76079

File tree

1 file changed

+5
-7
lines changed
  • i18n/en/docusaurus-plugin-content-docs/current/about/understanding

1 file changed

+5
-7
lines changed

i18n/en/docusaurus-plugin-content-docs/current/about/understanding/naming.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The methodology uses specific terms such as:
1717
- "app", "process", "page", "feature", "entity", "shared" as layer names,
1818
- "ui', "model", "lib", "api", "config" as segment names.
1919

20-
Original naming is crucial to prevent confusion among team members and new developers joining the project. Using unique names also helps when seeking help from the community.
20+
It is very important to stick to these terms to prevent confusion among team members and new developers joining the project. Using standard names also helps when asking for help from the community.
2121

2222
## Naming Conflicts {#when-can-naming-interfere}
2323

@@ -27,15 +27,13 @@ Naming conflicts can occur when terms used in the FSD methodology overlap with t
2727
- `FSD#page` vs log page,
2828
- `FSD#model` vs car model.
2929

30-
For example, a developer seeing the word "process" in the code will spend unnecessary time trying to understand which process they are talking about.
30+
For example, a developer who sees the word "process" in the code will spend extra time trying to figure out what process is meant. Such **collisions can disrupt the development process**.
3131

32-
These **collisions can disrupt the development process**, as developers may spend extra time trying to figure out exactly what they are talking about.
32+
When the project glossary contains terminology specific to FSD, it is critical to be careful when discussing these terms with the team and technical disinterested parties.
3333

34-
When the project glossary contains terminology specific to FSD, it is critical to exercise caution when discussing these terms with the team and non-technical stakeholders.
34+
To communicate effectively with the team, it is recommended that the abbreviation "FSD" be used to prefix the methodology terms. For example, when talking about a process, you might say, "We can put this process on the FSD features layer."
3535

36-
To communicate effectively with the team, it is recommended that the abbreviation "FSD" be used to prefix the methodology terms. For example, when talking about a process, you might say, "We can put this process at the FSD level."
37-
38-
Conversely, when communicating with non-technical stakeholders, it is best to limit the use of FSD terminology and refrain from mentioning the internal structure.
36+
Conversely, when communicating with non-technical stakeholders, it is better to limit the use of FSD terminology and refrain from mentioning the internal structure of the code base.
3937

4038
## See also {#see-also}
4139

0 commit comments

Comments
 (0)