<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Hi<br>
<br>
<blockquote cite="mid:20090713183507.GB11878@pmichaud.com" type="cite">
<pre wrap="">Ed: Exactly what "normal spacing rules" are you referring to here?
</pre>
</blockquote>
<br>
I misunderstood a PmWiki feature and I *thought* that the
"$WikiWordCount['PmWiki'] = 0;" feature was actually a feature which
controlled which CamelCase words should be expanded. I was wrong
though (but it would have been a useful feature...)<br>
<br>
In other words I thought there was an option to prevent "PmWiki" from
being turned into "Pm Wiki" when automatic spacing was enabled. (I have
since reviewed the code and realised what's what though)<br>
<br>
<br>
The rest of your email sounds like you are agreeing that it would be
useful to draw up a list of (probably only a few) words which are
"correctly" spelt as a CamelCase word and not as a spaced word? We
could then document that list and it would help keep the documentation
consistent going forward<br>
<br>
I'm not sure what your rules are on creating new pages, so would
someone mind starting me off with a page please?<br>
<br>
Suggested list of "proper nouns" (wrt pmwiki) for that page appears to
be:<br>
<br>
* PageList (suggest this spelling since it's the current documentation
pagename)<br>
* WikiWikiWeb<br>
* ChangeLog (see: <a class="moz-txt-link-freetext" href="http://en.wikipedia.org/wiki/Changelog">http://en.wikipedia.org/wiki/Changelog</a>)<br>
* AuthUser - this feels unnecessary to me, can I ask for a second
opinion?<br>
* PerGroup - feels VERY much unnecessary, can I ask for a second
opinion?<br>
* WikiStyles<br>
* InterMap<br>
<br>
<br>
Replies to your email:<br>
<br>
<blockquote cite="mid:20090713183507.GB11878@pmichaud.com" type="cite">
<blockquote type="cite">
<pre wrap="">* [[AuthUser]] - should this be [[Auth User]]?
* [[PerGroup customizations]]
</pre>
</blockquote>
<pre wrap=""><!---->
These look correct to me in the original.
</pre>
</blockquote>
<br>
Err, well yes, but my point was that the "house style" appears to be to
minimise the use of camel case now, so things should only be spelt like
that if are effectively "proper nouns" wrt to this project. I can see
some argument for AuthUser to remain as a single word (although it
feels weak to me?), but [[Per Group Customisation]] feels much better
to me than [[PerGroup Customisation]] (Why is PerGroup a single word?
I don't see why it should be promoted to a consistent camel case
spelling?)<br>
<br>
<br>
<blockquote cite="mid:20090713183507.GB11878@pmichaud.com" type="cite">
<blockquote type="cite">
<pre wrap="">* [[Custom wiki styles]] - elsewhere "WikiStyles" is quite common,
versus "Wiki Styles" here?
</pre>
</blockquote>
<pre wrap=""><!---->
I prefer "WikiStyles" to "Wiki Styles"
</pre>
</blockquote>
<br>
Ok... This is one which is quite widely varied, but not too hard to
argue in favour of it being "promoted" to a CamelCase word. After a
quick scan this word is perhaps the most inconsistently used link name,
so it would be good to choose a house style and stick with it?<br>
<br>
<blockquote cite="mid:20090713183507.GB11878@pmichaud.com" type="cite">
<blockquote type="cite">
<pre wrap="">* [[PageDirectives]]
</pre>
</blockquote>
<pre wrap=""><!---->
I can go either way on this one.
</pre>
</blockquote>
<br>
Then can I recommend we minimise CamelCase words unless they feel
extremely special and a core feature of the application? Therefore
lets make that [[Page Directives]] ?<br>
<br>
<br>
<blockquote cite="mid:20090713183507.GB11878@pmichaud.com" type="cite">
<blockquote type="cite">
<pre wrap="">Patrick - can you please give an official opinion on the exceptions and
I will work through the docs and try to fix everything? I recommend
that these are then put in as the default "don't space" config param
</pre>
</blockquote>
<pre wrap=""><!---->
I don't understand what you mean by "don't space" config param,
though -- can you be more explicit?
</pre>
</blockquote>
<br>
OK, I misunderstood the PmWiki functions available (explanation at the
top)<br>
<br>
However, what I would write now is "can we document the exceptions, use
those consistently in the documentation and make the documentation as
strongly consistent as possible"<br>
<br>
I think actually there is a second level of consistency we can fix at
the same time (and this has nothing to do with link styles!). This is
down to capitalisation of links, eg should we write:<br>
<br>
- Page Directives, or<br>
- Page directives?<br>
<br>
Can we get a second list going of anything that people consider SHOULD
be spaced, but SHOULD be spelt in capitals?<br>
<br>
I guess these "House Styles" should become a page under the PmWiki
documentation section? Can you start me off with a recommended page
name and paste in the list from the top? Perhaps others will then
start the debate I asked for in the first place and contribute any
other words they feel should be documentated as special?<br>
<br>
Regards<br>
<br>
Ed W
</body>
</html>