less-docs icon indicating copy to clipboard operation
less-docs copied to clipboard

JS API

Open jonathanong opened this issue 11 years ago • 7 comments
trafficstars

http://lesscss.org/usage/

there's no docs on the JS API. can't build anything with less wityhout it

jonathanong avatar Jul 23 '14 21:07 jonathanong

Yes its quite lacking. The options are the same as http://lesscss.org/usage/#using-less-in-the-browser You could also take a look at the source of less.js or grunt-contrib-less

lukeapage avatar Jul 24 '14 11:07 lukeapage

It's not lacking, it's absent. The old docs had this. Why remove it?

khrome avatar Sep 30 '14 19:09 khrome

@khrome

The old docs had this.

Hmm, where exactly? Everything that was at the old site (e.g. https://github.com/less/old-lesscss.org/blob/master/templates/pages/usage.md) is at the new one too (http://lesscss.org/#using-less, http://lesscss.org/usage/). The only confusing part is that it's now splitted into two parts (the "old" summary and the "new" details, but that's up to a community to improve that ;)

seven-phases-max avatar Sep 30 '14 20:09 seven-phases-max

Hmm, you are quite correct. In the past I've seen some docs, It must've been some blog post I stumbled across. If it crosses my path again, I'll point you to it. It really would be handy to have docs on this, though. Reading the source isn't rough, but it does take a lot more time. Thanks for the project and effort, didn't realize the programmatic usage docs were always non-existent.

khrome avatar Oct 01 '14 15:10 khrome

Are you accepting PRs for this? Is there an appropriate location for it?

christophercliff avatar Jan 23 '15 16:01 christophercliff

@christophercliff yes, we will gladly accept pull request for documentation, thank you in advance :) My first guess would be to put it here, but do not take it as a dogma.

SomMeri avatar Jan 24 '15 13:01 SomMeri

We had a vague plan to document with jsdoc and auto generate but im not sure how viable that is with our project structure. It wouldnt stop us merging any prs though.

lukeapage avatar Jan 24 '15 13:01 lukeapage