#pragma section-numbers 2

<<Include(A:dev)>>

= Templates consolidation =

'''Status: Project'''

'''Main proponents: DavidDemelier'''

/!\ This is a speculative project and does not represent any firm decisions on future behavior. 

In the progress of making more homogeneous style in Mercurial, this project proposes to unify the naming convention of templates.

== Goal ==

Mercurial didn't enforce a coding style on many areas: hgrc (see ConfigConsolidationPlan), environment variables, templates, and so on.

== Detailed description ==

Not having a correct convention leads into different styles. See the following templates:

  * activebookmark
  * changessincelatesttag
  * file_copies_switch
  * latesttagdistance

As proposed in the ConfigConsolidationPlan, I propose a mechanism where all hyphens and underscore get silently discarded. Thus, we can fix a correct naming style without breaking any user code.

I propose to use underscores everywhere because '''changessincelatesttag''' is not readable. No, it really isn't.

== Roadmap ==

 * (./) Naming style
 * {X} Implement a function to discard hyphens and underscores
 * {X} Update the templates documentation to use underscores

== See Also ==

  * ConfigConsolidationPlan

----
CategoryDeveloper CategoryNewFeatures