@rules

[dwins]

Support @rules for top-level declarations. As noted in this geoserver ticket one use would be for style-level metadata like the Title and Name.

[aaime]

So, how would it look like? Something like:

@name Polygon fill;
@title A simple gray polygon fill;

placed at the top of the css file?

[dwins]

Yes, just like that. In docs we would probably want to try and consistently use quotes as bare words have somewhat surprising behavior (apostrophes introduce parsing errors, whitespaces are collapsed.)

[jsanz]

Any advance on this issue?

There is no way (AFAIK) to set up a title and abstract texts on CSS syntax at style level so they don't appear at Capabilities documents and so on.