Comments (9)
In Sass, required arguments are those who do not have a default value.
from sassdoc.
In Sass, required arguments are those who do not have a default value.
Yes, and they also need to be before any named argument in the signature.
I'm more thinking about some sort of visual differentiation in generated doc.
Just because we can.
(Doesn't mean we should... :)
from sassdoc.
What do you have in mind?
from sassdoc.
What do you have in mind?
Maybe a different color, or a small label, or border.
Let me use SassDoc a bit more and generate docs for some of my projects, and it may make sense afterward. ;-)
from sassdoc.
Alright. Keep me updated :)
from sassdoc.
I'd like to close this any time soon. Hit me up @pascalduez. :)
from sassdoc.
So here are some quick mockups. Actually, I like the idea but wondering if it's all worth.
You judge, you close ;-)
It should ideally make the difference between true required args, and defaults without comments...
1
2
3
from sassdoc.
Okay for the *. I'll do that tonight.
from sassdoc.
After thinking about it, I feel like the — in Default value column is enough. If you think otherwise, feel free to open this issue back so we can chat about it.
from sassdoc.
Related Issues (20)
- Support documentation for css custom properties HOT 1
- Maintenance Status HOT 1
- "verbose" and "strict" parameters are ignored if defined within configuration
- SASS files correctly parsed but the documentation is not generated HOT 4
- feature request (?): link to image HOT 2
- Screen overflow on mobile
- `@see` doesn't recognize sass module references
- Warning for Annotation `property` when it is not being used
- Allow more than one @output HOT 1
- [ERROR] Could not find any executable for "sass-convert". Operation Aborted. HOT 3
- Keywords feature
- [WARNING] Parser for annotation `flag` not found. Location: `linePoster.test.scss:5:8` HOT 1
- Interested in TypeScript definitions? HOT 2
- esm support
- Remove vulnerable `update-notifier` dependency
- Update the version of jQuery used in the built docs
- How to document @function that takes parameter a map key.
- Deprecation warning for core-js when installing sassdoc. Upgrade needed.
- Overrides the editor.definitionLinkOpensInPeek setting. HOT 4
- Default theme: item group is not included in item name link HOT 1
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 sassdoc.