Comments (7)
The readme should contain example's linted in the same way as the code is linted in the rest of the project. I think that is a reasonable assumption.
from standard-readme.
What if the user could provide the name of a linter program? Opt-in might be nice: perhaps look for a property named "lint" under "scripts" and run that?
from standard-readme.
Vote for suggestion. It not make sense to be requirement.
What if the user could provide the name of a linter program?
It is not standard-readme
job, and it should not care.
from standard-readme.
We don't have any optional provisions for users, at the moment; there's no config for standard-readme, basically. So I'm not sure your suggestion works well, @noffle.
Suggestion makes the most sense, for me. But it is partially standard-readme's job; the code snippets are part of the README. What I don't want is to enforce standard in the code-base, though.
from standard-readme.
One trick might be to opt-in by embedding an HTML comment hint into your markdown. Something like:
<!--
lint: standard
-->
```js
var foo = require('foo')
console.log(foo(14))
```
This will prevent the hints from showing up in the rendered markdown, but make it easy to perform a pre-processing step in standard-readme that runs the program standard
with the following code snippet on stdin
. (This'd make a nice little stand-alone UNIXy module!)
from standard-readme.
Still don't make sense. It's not readme job. Exactly because there's already a tool for such thing, it's not make sense to couple tools - SoC for the win. :) JUst suggestion is enough and users simple will run it.
from standard-readme.
I am going to keep this language agnostic. I used @martinheidegger's suggestion, added it as a requirement.
from standard-readme.
Related Issues (20)
- Improvement in License section HOT 1
- Question on Usage section HOT 1
- Question: clarifying on rules for install, usage, and contributing HOT 3
- Installation fails because of missing dependency to opencollective-postinstall HOT 1
- README.cn.md doesn't follow naming convention HOT 8
- Introduce REUSE compliance/compatibility HOT 1
- 您好,能写一个新手能看懂的教程吗?
- cat: spec.md: No such file or directory HOT 1
- README, Markdown and other formats HOT 1
- It's a good markdown file HOT 1
- Create a logo for Open Collective
- The "Install" section may not seem right for deployable websites HOT 2
- Does this project comply with standard-readme HOT 1
- Table of Contents Built in to GitHub HOT 2
- Demo
- Some links in the maximal example are broken HOT 4
- Add support for CHANGELOG.md? HOT 2
- Add a Credits/Thanks/Acknowledgements section HOT 6
- Examples use "contributing" which results in an error HOT 3
- Chinese translation HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from standard-readme.