Stress `filename` option as a must for most programmatic `less.render` use-cases.

Open

#332 opened on May 6, 2015 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

docs up-for-grabs

Dominant language: Less
Stars: 680
Forks: 442
PR merge metrics: No merged PRs in 30d

Description

See #2342, #2583. (relative imports, ulrs, data-uris as well as source-maps and similar compiled-less-file-depended things just won't work properly w/o this option).

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Research direction

Start with the documentation for programmatic less.render use and review the related issues #2342 and #2583. Update the relevant guidance to explain when the filename option is needed for relative imports, URLs, data URIs, source maps, and other compiled-file-dependent behavior; the documentation should clearly state the expected requirement.

Written by the indexing model from the issue text.

Assessment

Domain: documentation
Issue type: Documentation
Difficulty: 2/5
Estimated time: 1-3 hours
Activity status: Stale
Clarity: Mostly clear
Newbie friendliness: 35/100

A short digest of beginner-friendly GitHub issues.

Stress `filename` option as *a must* for most programmatic `less.render` use-cases.