[PATCH] docs: Document camelCase preference for XML elements and attributes

Erik Skultety eskultet at redhat.com
Thu Oct 15 12:22:00 UTC 2020


On Thu, Oct 15, 2020 at 11:34:39AM +0200, Michal Privoznik wrote:
> Recently I've merged a patch that used hyphens in an attribute
> name. I fixed it later, but turned out we don't document our
> preference which is camelCase.
> 
> Suggested-by: Erik Skultety <eskultet at redhat.com>
> Signed-off-by: Michal Privoznik <mprivozn at redhat.com>
> ---
> 
> I'm not sure this is the correct place to put this, suggestions welcome.
> 
>  docs/api_extension.html.in | 6 ++++++
>  1 file changed, 6 insertions(+)

I perceive api_extension as an overall guideline what a patch series should
look like if you plan on introducing a new API/feature. I still think that XML
attribute naming counts as style convention just like the if-else block
formatting, spacing, indentation, etc.

Erik




More information about the libvir-list mailing list