| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
| |
Reviewed by: bofh
Differential Revision: https://reviews.freebsd.org/D43214
|
|
|
|
|
|
|
| |
- Change INDEX-8 to INDEX-13
- Remove references to portmaster/portupgrade [1]
Approved by: portmgr [1]
|
|
|
|
| |
The Spacing rule also catches [a-z].FreeBSD so add an exception.
|
| |
|
| |
|
|
|
|
| |
github is used as GitHub for brand recognition.
|
|
|
|
|
|
|
| |
- In browser section the package is mentioned as www/dillo but dillo has
been removed from the tree in favor of www/dillo2
- Pet vale while I am here
- Add missing keywords from this file in the Vale vocabulary
|
|
|
|
|
|
|
|
|
| |
As 14.0-RELEASE is out update the available pkg information.
Estimated EOL for stable/14 branch will be updated once the release is
handed over to Sec Team.
Approved by: portmgr (blanket)
|
| |
|
|
|
|
| |
action keyword was removed in recent versions of vale.
|
|
|
|
|
|
|
|
|
|
| |
e.g/eg or ie/i.e actually hails from Latin root and do not have any
specific general acceptance in any English standards or at least should
not be written in technical documentation. But we have a lot of these in
our documentation. Throw errors for such occurrences and replace those
with for example or that is.
Approved by: carlavilla
|
|
|
|
|
| |
Currently due to the nonword keyword all the pronouns are are considered
as sub words and is throwing errors. Grab pronouns on whole words only.
|
|
|
|
|
|
|
| |
- Add new terms from phb/testing
- Fix binutil keyword [1]
Reported by: ceri [1]
|
|
|
|
|
|
|
| |
Add FreeBSD specific terms unavailable in the Dictionary from
porters-handbook/versions section.
Approved by: bcr carlavilla (mentor implicit)
|
|
|
|
|
|
|
|
|
|
| |
After some careful consideration and thoughts the Weasel rule is being
removed because currently there are 18805 suggestions which will be
really time consuming to fix as rewording the sentences from weasel
words are a bit complicated.
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D40063
|
|
|
|
|
|
|
|
| |
Add various pronouns and their sub derivatives which are widely used in
our websites and documentation specially the usage of you.
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D40029
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
- Remove spelling-exceptions list
- Vale has it's own engine to add custom vocabulary for adding project
specific keywords. Add a vocabulary named Terms
- Add the file accept.txt which words should be accepted without any
errors
- Utilize documentation/content/en/books/arch-handbook/mac/_index.adoc
as proof of concept to remove all sort of errors/warnings/suggestion.
- Remove EOLSpace
- Fix Semantic Line Breakings
- Add relevant keywords to the new Vocab file accept.txt
- Some codewords were not marked with single tick ` so mark those properly
that spelling engine do not throw errors
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D39703
|
|
|
|
|
|
|
|
| |
Vale now comes with it's own Repetition rules. Utilize that rule instead
of the FreeBSD one and also remove the FreeBSD rule of Repititon.
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D39704
|
|
|
|
|
|
|
|
|
| |
Suggest to empty square brackets in `link:` macros when the displayed
text coincides with the URL.
Reviewed by: bofh, grahamperrin
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D39569
|
|
|
|
|
|
|
|
|
| |
Vale started shipping with a dictionary(en_US) of it's own which looks
like good enough for our purpose. So this patch removes the FreeBSD
Custom Dictionary and uses the Vale's stock one.
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D39694
|
|
|
|
|
|
|
|
|
|
| |
In our doc guidelines we use "One Sentence Per Line" or more technically
Semantic Line Breaking. Use vale to implement this. This patch also
handles some exceptions with Inc. and e.g. which will contain . but not
apparently at the end of line.
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D39560
|
|
|
|
|
|
|
|
|
|
|
| |
- Reduce error level to suggestion
- Remove two keywords which are all over our repository due to the reports
frequency
- monthly
- quarterly
Approved by: bcr
Differential Revision: https://reviews.freebsd.org/D39685
|
|
Currently we do not have any language checker for our documentation
system. In previous we used igor which has not been upgraded and
sometimes are also not compatible with AsciiDOC and additionally the
maintainer is no longer a committer anymore. Considering this and
widespread use of Vale we have given a test on vale and initiating
introduction of vale with some basic set of rules. The rules are
described as below:
BrandTerms: Like The FreeBSD Project every major vendors and Companies
have specific rules on writing their Brand Name. Although we never read
but according to the Copyright rules of The FreeBSD Foundation whenever
we are writing we should write FreeBSD rather than freebsd. That is our
brand value. Similar to that we should be respective to other's brand
value and write PostgreSQL, Node.js, Let's Encrypt etc.
Contractions: Contracted words should not be used. This rule avoids all
contractions and suggests full words.
Hang: We often try to use the word hang to convey the meaning that the
application has stopped responding. This rule proposes better wording
Repetition: Often while working we type the same words twice; this
mostly happen we leave the keyboard while writing and returning to desk.
This rule finds repeated words
Weasel: This rule handles avoiding weasel words
ConsciousLanguage: This rule proposes uses of conscious languages like
avoiding the words white/black/master/slave
EOLSpacing: In most of our documents EOL spacing is present which is
not the ideal situation. This rule warns the user
Hyphens: Often adverbs ending with 'ly' are being added with a hyphen
which is wrong. This rule handles this
Spacing: Often double spaces are hard to catch on plain eye which is addressed here
Spelling: Spelling checks using a custom dictionary from
http://wordlist.aspell.net which uses strictly en_US and do not accept
the BRITISH spelling variant. It has also an exception list to ignore
the FreeBSD specific terms. Currently the list is a basic one with
minimal words just as a proof of concept
The next step will be restarting the CI process of FreeBSD docs, reduce
noises and implement git hooks.
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D37297
|