Search Results for "comments"

Docco is a documentation generator by Jeremy Ashkenas that embraces the literate-programming style: it takes your source code and produces annotated HTML documentation that shows your comments side-by-side with your code. The idea is to read code like a book — commentary on one side, code on the other — which helps reviewers and learners understand intent and implementation simultaneously. It supports many languages (via configuration) and is intentionally quick and dirty, prioritizing lightweight output rather than heavy tooling. ...

...It tallies physical lines, source lines, comment lines, and blank lines, giving you a quick snapshot of code size across files or entire directories. The utility is language-aware through lightweight detectors and patterns, so it can ignore comments correctly and avoid counting generated or minified files if you configure it to. Output can be human-readable for quick checks or machine-readable (like JSON) for CI pipelines that track repository growth over time. It supports typical developer conveniences such as glob patterns, file/directory ignores, and sensible defaults so you can drop it into existing workflows without fuss. ...

cson (CoffeeScript‑Object‑Notation) is a human-friendly data serialization format similar to JSON but using CoffeeScript syntax, with a library (and CLI) to parse and serialize between CSON, JSON, and JavaScript objects. Executing the method with a callback still executes the method synchronously. Requires or parses a file path of the desired format into an Object If the format option is not specified, we use the filename to detect what it should be; otherwise, we default to parsing CSON.