Skip to content

Commit

Permalink
Merge pull request #320 from jason-fox/feature/text-lint
Browse files Browse the repository at this point in the history
Format and lint Markdown text files
  • Loading branch information
fgalan authored Feb 20, 2019
2 parents 2303f02 + efe523e commit 08117b5
Show file tree
Hide file tree
Showing 19 changed files with 1,510 additions and 1,043 deletions.
3 changes: 3 additions & 0 deletions .remarkrc.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
exports.settings = { bullet: '-', paddedTable: true };

exports.plugins = [require('./node_modules/remark-preset-lint-recommended')];
196 changes: 196 additions & 0 deletions .textlintrc
Original file line number Diff line number Diff line change
@@ -0,0 +1,196 @@
{
"rules": {
"terminology": {
"defaultTerms": false,
"terms": [
// Brands
"Airbnb",
"Android",
"AppleScript",
"AppVeyor",
"AVA",
"BrowserStack",
"Browsersync",
"Codecov",
"CodePen",
"CodeSandbox",
"DefinitelyTyped",
"EditorConfig",
"ESLint",
"FIWARE",
"GitHub",
"GraphQL",
"iOS",
"JavaScript",
"JetBrains",
"jQuery",
"LinkedIn",
"Lodash",
"MacBook",
"Markdown",
"OpenType",
"PayPal",
"PhpStorm",
"RubyMine",
"Sass",
"SemVer",
"TypeScript",
"UglifyJS",
"WebStorm",
"WordPress",
"YouTube",
["JSDocs?", "JSDoc"],
// ["Node(?:js)?", "Node.js"],
["React[ .]js", "React"],
["SauceLabs", "Sauce Labs"],
["StackOverflow", "Stack Overflow"],
["styled ?components", "styled-components"],
["HTTP[ /]2(?:\\.0)?", "HTTP/2"],
["OS X", "macOS"],
["Mac ?OS", "macOS"],
["a npm", "an npm"],

// ECMAScript
"ECMAScript",
["ES2015", "ES6"],
["ES7", "ES2016"],

// Abbreviations
"3D",
["3-D", "3D"],
"Ajax",
"API",
["API['’]?s", "APIs"],
"CSS",
"GIF",
"HTML",
"HTTPS",
"IoT",
"I/O",
["I-O", "I/O"],
"JPEG",
"MIME",
"OK",
"PaaS",
"PDF",
"PNG",
"SaaS",
"URL",
["URL['’]?s", "URLs"],
["an URL", "a URL"],
["wi[- ]?fi", "Wi-Fi"],

// Names
"McKenzie",
"McConnell",

// Words and phrases
"ID", // http://stackoverflow.com/questions/1151338/id-or-id-on-user-interface
["id['’]?s", "IDs"],
["backwards compatible", "backward compatible"],
["build system(s?)", "build tool$1"],
["CLI tool(s?)", "command-line tool$1"],
["he or she", "they"],
["he/she", "they"],
["\\(s\\)he", "they"],
["repo\\b", "repository"],
["smartphone(s?)", "mobile phone$1"],
["web[- ]?site(s?)", "site$1"],

// Single word
["auto[- ]complete", "autocomplete"],
["auto[- ]format", "autoformat"],
["auto[- ]fix", "autofix"],
["auto[- ]fixing", "autofixing"],
["back[- ]end(\\w*)", "backend$1"],
["bug[- ]fix(es?)", "bugfix$1"],
["check[- ]box(es?)", "checkbox$1"],
["code[- ]base(es?)", "codebase$1"],
["co[- ]locate(d?)", "colocate$1"],
["end[- ]point(s?)", "endpoint$1"],
["e[- ]mail(s?)", "email$1"],
["file[- ]name(s?)", "filename$1"],
["front[- ]end(\\w*)", "frontend$1"],
["hack[- ]a[- ]thon(s?)", "hackathon$1"],
["host[- ]name(s?)", "hostname$1"],
["hot[- ]key(s?)", "hotkey$1"],
["life[- ]cycle", "lifecycle"],
["life[- ]stream(s?)", "lifestream$1"],
["lock[- ]file(s?)", "lockfile$1"],
["mark-up", "markup"], // “mark up” as a verb is OK
["meta[- ]data", "metadata"],
["name[- ]space(s?)", "namespace$1"],
["pre[- ]condition(s?)", "precondition$1"],
["pre[- ]defined", "predefined"],
["pre[- ]release(s?)", "prerelease$1"],
["run[- ]time", "runtime"],
["screen[- ]shot(s?)", "screenshot$1"],
["screen[- ]?snap(s?)", "screenshot$1"],
["sub[- ]class((?:es|ing)?)", "subclass$1"],
["sub[- ]tree(s?)", "subtree$1"],
["time[- ]stamp(s?)", "timestamp$1"],
["touch[- ]screen(s?)", "touchscreen$1"],
["user[- ]name(s?)", "username$1"],
["walk[- ]through", "walkthrough"],
["white[- ]space", "whitespace"],
["wild[- ]card(s?)", "wildcard$1"],

// Multiple words
["change-?log(s?)", "change log$1"],
["css-?in-?js", "CSS in JS"],
["code-?review(s?)", "code review$1"],
["code-?splitting", "code splitting"],
["end-?user(s?)", "end user$1"],
["file-?type(s?)", "file type$1"],
["open-?source(ed?)", "open source$1"],
["regexp?(s?)", "regular expression$1"],
["style-?guide(s?)", "style guide$1"],
["tree-?shaking", "tree shaking"],
["source-?map(s?)", "source map$1"],
["style-?sheet(s?)", "style sheet$1"],
["user-?base", "user base"],
["web-?page(s?)", "web page$1"],

// Hyphenated
["built ?in", "built-in"],
["client ?side", "client-side"],
["command ?line", "command-line"],
["end ?to ?end", "end-to-end"],
["error ?prone", "error-prone"],
["higher ?order", "higher-order"],
["key[/ ]?value", "key-value"],
["server ?side", "server-side"],
["two ?steps?", "two-step"],
["2 ?steps?", "two-step"],

// Starts from a lower case letter in the middle of a sentence
["(\\w+[^.?!]\\)? )base64", "$1base64"],
["(\\w+[^.?!]\\)? )stylelint", "$1stylelint"],
["(\\w+[^.?!]\\)? )webpack", "$1webpack"],
["(\\w+[^.?!]\\)? )npm", "$1npm"],

// Typos
["environemnt(s?)", "environment$1"],
["pacakge(s?)", "package$1"],
["tilda", "tilde"],
["falsey", "falsy"]
]
},
"common-misspellings": true,
"write-good": {
"adverb": false,
"passive": false,
"tooWordy": false,
"weasel": false,
"so": false,
"thereIs": false
},
"no-dead-link": {
"ignoreRedirects": true,
"ignore": [
"mailto:*",
"https://oauth.net"
]
}
}
}
2 changes: 2 additions & 0 deletions .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ before_install:

before_script:
- npm run lint
# - npm run lint:text
- npm run lint:md

after_script:
- npm run test:coveralls
Expand Down
55 changes: 26 additions & 29 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,48 +7,45 @@
[![Coverage Status](https://coveralls.io/repos/github/telefonicaid/perseo-fe/badge.svg?branch=master)](https://coveralls.io/github/telefonicaid/perseo-fe?branch=master)
![Status](https://nexus.lab.fiware.org/static/badges/statuses/perseo.svg)


CEP implementation for IoT platform

## Index

* [Architecture](documentation/architecture.md)
* [Logs & Alarms](documentation/logs.md)
* O&M
* [Deployment](documentation/deployment.md)
* [Configuration](documentation/configuration.md)
* [Administration](documentation/admin.md)
* [Metrics API](documentation/metrics_api.md)

* [API](documentation/api.md)
* [Plain rules](documentation/plain_rules.md)
* [Errors](documentation/errors.md)
* [Data model](documentation/models.md)
* [Available actions for PEP](documentation/pep_actions.md)
* [Documentation for developers of perseo](documentation/development.md)
- [Architecture](documentation/architecture.md)
- [Logs & Alarms](documentation/logs.md)
- O&M

- [Deployment](documentation/deployment.md)
- [Configuration](documentation/configuration.md)
- [Administration](documentation/admin.md)
- [Metrics API](documentation/metrics_api.md)

- [API](documentation/api.md)
- [Plain rules](documentation/plain_rules.md)
- [Errors](documentation/errors.md)
- [Data model](documentation/models.md)
- [Available actions for PEP](documentation/pep_actions.md)
- [Documentation for developers of perseo](documentation/development.md)

| :dart: [Roadmap](documentation/roadmap.md) |
|---|
## License
| ------------------------------------------ |

Perseo FE is licensed under [Affero General Public License (GPL)
version 3](./LICENSE).

## License

Perseo FE is licensed under [Affero General Public License (GPL) version 3](./LICENSE).

### Are there any legal issues with AGPL 3.0? Is it safe for me to use?

There is absolutely no problem in using a product licensed under AGPL 3.0. Issues with GPL
(or AGPL) licenses are mostly related with the fact that different people assign different
interpretations on the meaning of the term “derivate work” used in these licenses. Due to this,
some people believe that there is a risk in just _using_ software under GPL or AGPL licenses
(even without _modifying_ it).
There is absolutely no problem in using a product licensed under AGPL 3.0. Issues with GPL (or AGPL) licenses are mostly
related with the fact that different people assign different interpretations on the meaning of the term “derivate work”
used in these licenses. Due to this, some people believe that there is a risk in just _using_ software under GPL or AGPL
licenses (even without _modifying_ it).

For the avoidance of doubt, the owners of this software licensed under an AGPL 3.0 license
wish to make a clarifying public statement as follows:

> Please note that software derived as a result of modifying the source code of this
> software in order to fix a bug or incorporate enhancements is considered a derivative
> work of the product. Software that merely uses or aggregates (i.e. links to) an otherwise
> unmodified version of existing software is not considered a derivative work, and therefore
> it does not need to be released as under the same license, or even released as open source.
> Please note that software derived as a result of modifying the source code of this software in order to fix a bug or
> incorporate enhancements is considered a derivative work of the product. Software that merely uses or aggregates (i.e.
> links to) an otherwise unmodified version of existing software is not considered a derivative work, and therefore it
> does not need to be released as under the same license, or even released as open source.
Loading

0 comments on commit 08117b5

Please sign in to comment.