[PATCH] docs: Document camelCase preference for XML elements and attributes
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.
More information about the libvir-list