retext-ibmstyleguide

1.0.1 • Public • Published

retext-ibmstyleguide

Word usage guidence for technical writers.

retext-ibmstyleguide is a retext plugin for the word usage advice in IBM style guide. It highlights errors and provide word usage advice.

Installation

npm:

npm install retext-ibmstyleguide

Usage

For the following file, example.txt:

You can utilize a shorter word.
Be advised, don’t do this.
That’s the appropriate thing to do.

And our script, example.js, looks as follows:

var vfile = require('to-vfile');
var report = require('vfile-reporter');
var retext = require('retext');
var ibmstyleguide = require('retext-ibmstyleguide');
 
retext()
  .use(ibmstyleguide)
  .process(vfile.readSync('example.txt'), function (err, file) {
    console.error(report(err || file));
  });

Yields:

   1:9-1:16  warning  utilize [v.] Replace with "use."               utilize  ibmstyleguide
  2:19-2:21  warning  do (a step) [v.] Use "complete" or "perform."  do       ibmstyleguide
  3:33-3:35  warning  do (a step) [v.] Use "complete" or "perform."  do       ibmstyleguide
 
⚠ 3 warnings
 

API

retext().use(ibmstyleguide)

Rules

See index.json

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 1.0.1
    1
    • latest

Version History

  • Version
    Downloads (Last 7 Days)
    • Published
  • 1.0.1
    1
  • 1.0.0
    0

Package Sidebar

Install

npm i retext-ibmstyleguide

Weekly Downloads

1

Version

1.0.1

License

MIT

Last publish

Collaborators

  • gaurav-nelson