Rev 57: Summarize the consensus reached with jelmer which seems to satisfy everybody. in file:///home/vila/src/bzr/devnotes/

[Vincent Ladeuil]

At file:///home/vila/src/bzr/devnotes/

------------------------------------------------------------
revno: 57
revision-id: v.ladeuil+lp at free.fr-20110528065211-bqmwryquzwpjcclt
parent: v.ladeuil+lp at free.fr-20110519084049-lzn3lkganhsga7wr
committer: Vincent Ladeuil <v.ladeuil+lp at free.fr>
branch nick: devnotes
timestamp: Sat 2011-05-28 08:52:11 +0200
message:
  Summarize the consensus reached with jelmer which seems to satisfy everybody.
-------------- next part --------------
=== modified file 'configuration.txt'
--- a/configuration.txt	2011-05-19 08:40:49 +0000
+++ b/configuration.txt	2011-05-28 06:52:11 +0000
@@ -204,8 +204,20 @@
 
 * bzrlib options are grouped by topic (``branch``, ``tree``, ``repo``)
 
-* plugins are encouraged to prefix their options with their name (``qbzr.``
-  for qbzr).
+* plugins are encouraged to prefix their specific options with
+  their name (``qbzr.`` for qbzr)
+
+The topic based name seems to provide the best compromise:
+
+* option names are shorter,
+
+* collisions are detected at registration time so users are protected from
+  incompatibilities between plugins,
+
+* options that need to be used by several plugins (or shared between ``bzr``
+  core and plugins) should be discussed but these discussions are already
+  happening so the risk of misuse is low enough.
+
 
 Value
 -----