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
Member

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!

@@ -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
Member 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
Member 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 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.

None yet

2 participants