Oliver,

On Friday, 2016-07-29 08:32:27 +0200, you wrote:

> ...
> * Most users will use the HTML GUI of Bitbucket to create a new file.
> And Bitbucket will use the headline as file name.

At least now I understand  how these blank infested file names ever came
into the repository!

>                                     I don't know how to solve this other
> than to rename the stuff for them.

Is there a way to tell the Bitbucket GUI to only allow editing of exist-
ing files but to prevent the creation of new ones?  In my opinion creat-
ing a new file  is a rather lengthy process  involving several cycles of
editing and inspecting the results.   This shouldn't be done in the live
repository, anyway.

> * I would suggest to add the TOC to the navigation bar insert. Sure
> there might be one ore two pages with just a single heading, but these
> are the minority and usually things grow.

Good idea ... Stay tuned, but give me some time :-)

> * As men do not read instructions and especially not lengthy
> instructions like this) it would need a very dense summary of necessary
> commands and a checklist on the dos and donts when writing pages right
> on top of the README.

It's my strong conviction that people  (regardless of gender)  not will-
ing to READ  others' instructions  should rather not  WRITE documetation
meant for others.  I've been in this business for almost too long a time
now and have not yet been proven wrong.

> * As most users, especially the new ones, will experience the Wiki via
> Bitbucket, they won't see the README.txt until they checkout the
> repository. Why not make the README.txt a README.md and add it to the
> main TOC?

Good idea, too.  Is there someone fluent enough in Markdown who could do
that for me in a fraction of the time I would need?   I would then sugg-
est renaming the file to "DeveloperDocumentation.md" (using "hg mv") and
link it into the "Developers & Translators" section.

But before everybody starts shouting  "I'll do it for you!"  please wait
until I have integrated the "[TOC]" directive  into the upper navigation
bar, because this will entail a few changes to file "README.txt".  :-D

Sincerely,
  Rainer

------------------------------------------------------------------------------
_______________________________________________
Qlandkartegt-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/qlandkartegt-users

Reply via email to