Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

use markdown-magic for processing documentation #3597

Merged
merged 1 commit into from
Dec 7, 2018

Conversation

boneskull
Copy link
Contributor

Sorry about the churn here, as I recently updated these scripts.

I happened across markdown-magic which looked like an easier way to do the stuff we're doing to transform docs/index.md.

  • adopted markdown-magic for preprocessing
  • added scripts/markdown-magic.config.js with transforms
  • renamed some scripts in package-scripts.js
  • removed scripts/preprocess-docs.js
  • removed common-tags dep
  • removed mississippi dep
  • re-added through2 dep
  • added markdown-magic-package-json to easily dump stuff from package.json into the document; added an example of this at the end of docs/index.md with the gitter property

Also, @plroebuck, whatever was causing the indents in the usage output to not appear stopped happening; the indents are back!

@boneskull boneskull requested a review from plroebuck December 5, 2018 07:37
@@ -93,7 +93,7 @@ or as a development dependency for your project:
$ npm install --save-dev mocha
```

> Mocha currently requires Node.js v6.x or newer.
> As of v6.0.0, Mocha requires Node.js v6.0.0 or newer.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this reminds me; we really need to not publish the site on commits to master. I have no idea how to do that

const path = require('path');

exports.transforms = {
usage: (content, options) => {
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I could probably extract this into its own plugin.

@boneskull boneskull force-pushed the refactor/markdown-magic branch from f8e5a4a to df3ebfd Compare December 7, 2018 18:00
@boneskull boneskull merged commit 7d0fb1f into master Dec 7, 2018
@boneskull boneskull added semver-patch implementation requires increase of "patch" version number; "bug fixes" type: cleanup a refactor labels Dec 7, 2018
@boneskull boneskull added this to the v6.0.0 milestone Dec 7, 2018
@boneskull boneskull deleted the refactor/markdown-magic branch December 7, 2018 18:48
@coveralls
Copy link

coveralls commented Dec 8, 2018

Coverage Status

Coverage increased (+0.03%) to 90.501% when pulling df3ebfd on refactor/markdown-magic into 00d5e90 on master.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
semver-patch implementation requires increase of "patch" version number; "bug fixes" type: cleanup a refactor
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants