Rewrite content based on Vale linting: import_export.md
Problem to solve
The Vale linter is used to support grammar linting in GitLab documentation. As Vale was implemented after many of the GitLab documents were written, we have many documentation pages that do not meet the linting standards created by the GitLab Technical Writing team for Vale.
Further details
As an example, here's the output from a Vale test on the import_export.md file:
import_export.md
24:19 warning If possible, use gitlab.SubstitutionWarning
"administrator" instead of
"admin".
24:30 warning If possible, use gitlab.SubstitutionWarning
"administrator" instead of
"Admin".
36:46 warning Avoid using future tense: gitlab.FutureTense
"will inherit"
42:21 warning Avoid using future tense: gitlab.FutureTense
"will be"
52:21 warning Avoid using future tense: gitlab.FutureTense
"will NOT"
52:26 warning "NOT" has no definition. gitlab.Acronyms
80:206 warning If possible, use gitlab.SubstitutionWarning
"administrator" instead of
"Admin".
86:1 warning Shorter sentences improve gitlab.SentenceLength
readability (max 25 words).
86:101 suggestion Use "that's" instead of "that gitlab.Contractions
is", for a friendly, informal
tone.
107:78 warning Avoid using future tense: gitlab.FutureTense
"will appear"
Each of these messages point to a specific line:column in the noted file.
Proposal
Consider each error message, and see if you can rewrite the noted file with a solution.
Who can address the issue
Anyone with an understanding of basic written US English. Ideally, that person should also have some domain expertise in the subject area.