search

less / less-docs

Documentation for Less.
http://lesscss.org
Other
673 stars 446 forks source link

JS API #212

Open jonathanong opened 10 years ago

jonathanong commented 10 years ago

http://lesscss.org/usage/

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

lukeapage commented 10 years ago

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

khrome commented 10 years ago

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

seven-phases-max commented 10 years ago

@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 ;)

khrome commented 10 years ago

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.

christophercliff commented 9 years ago

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

SomMeri commented 9 years ago

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

lukeapage commented 9 years ago

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.