[buddypress-trac] [BuddyPress] #3243: CSS files need commenting and organisation

[buddypress-trac at lists.automattic.com]

#3243: CSS files need commenting and organisation
-------------------------+-----------------------------
 Reporter:  karmatosed   |      Owner:
     Type:  enhancement  |     Status:  new
 Priority:  normal       |  Milestone:  Awaiting Review
Component:  Theme        |    Version:  1.3
 Keywords:               |
-------------------------+-----------------------------
 With all the good work going on for 1.3 and beyond with the default theme
 I think to increase the usability having some form of commenting /
 organisation to build on what is already there could help.

 For instance an index and then listing things alphabetically /
 sectionally:

 ie:


 {{{
 /* STYLE CONTENTS
 **************************************************************************************/
 /* 1.0 activity
 **************************************************************************************/
 /* 2.0 adminbar
 **************************************************************************************/
 /* >>>>>> START STYLES
 **************************************************************************************/
 /* 1.0 activity
 **************************************************************************************/
 styles
 /* 2.0 adminbar
 **************************************************************************************/
 styles
 /* <<<<<< END STYLES
 **************************************************************************************/
 }}}

 I know it will be a point of discussion how these should be organised and
 that's a good thing.  However, I think before separate files are
 considered this 'in one page' documentation should occur.

 I feel it will help people know where to look for things along with make
 the CSS more accessible and maybe even encourage some new theme creators
 in the process.

 I am willing to put forward a patch for this assuming it's something that
 would be wanted and agreed on a structure.  I will have a think and
 probably update with a proposed structure assuming this is something that
 would be wanted to be contributed.

-- 
Ticket URL: <https://trac.buddypress.org/ticket/3243>
BuddyPress <http://buddypress.org/>
BuddyPress