1. I agree there's no need for a comments or discussion section in the manual. That's why we have the forum. We don't want to proliferate the places where we have to look for questions and answers.
2. I will let you know if I encounter any problems as "Manager". I'll need a day or so to test the functions I use.
3. I don't see much advantage to shortening the names for the namespaces which contain the media files. It will be a lot of work and the longer names can easily be handled with copy and paste. The cost of bits is pretty low these days and the longer names do make the code more readable. I'd say leave well enough alone.
4. I noticed that a lot of the pages you've migrated contain links to the Drupal manual pages. Take a look, for example, at
GPS Setup and Status [Opencpn]
The very first link takes you back to a Drupal manual page. It points to
Code:
http://opencpn.org/ocpn/Start_gps-setup
It needs to be changed to point to
Code:
opencpn:opencpn_user_manual:getting_started:gps_setup
Everyone working on the
project needs to be very careful about this. As long as the original user manual is still in place the Dokuwiki pages will look OK. When the Drupal pages are gone a huge chunk of the manual will disappear if those links haven't been corrected.
In every page you migrate, look for the little globe icon to the left of a link. That tells you the link is to an outside Web page. If the outside Web page is a page in the original user manual it needs to be changed to a link to a Dokuwiki page. If the Dokuwiki page doesn't exist it needs to be created in the proper place in the index structure and copied from the Drupal page.
5. In your instructions in the Edit User Manual page you say to log in as Editor into the old manual. That's not necessary. You can simply highlight the Drupal page, copy it to the clipboard, and paste it into the Dokuwiki CKG edit page. Save it, then edit it further with DW Edit.
In a few rare cases you might need to look at the Drupal source code to figure out why something didn't copy properly. In those cases you need to be logged in and able to switch to plain text editor. I found a couple cases where images had been encoded as binary strings in the HTML. I had to view the page, save the image file, upload it to Dokuwiki, and change the Dokuwiki code to point to the newly uploaded image.
With the exception of those few instances I found I did not need to log in to the Drupal manager at all. That streamlines the process a bit.
Fabbian