Hi Dan,

Thanks for your suggestions to improve the documentation of phpMyAdmin.

> Why not here also provide a link to
> http://localhost/phpmyadmin/Documentation.html ?

> It's not like one needs a password to see it.
> Also one might not be online, so cannot visit
> http://www.phpmyadmin.net/, while all along, the documentation is
> right under one's nose locally.

That sounds reasonable. I'll pass that to upstream.

> Also no need for the random string above.

I don't have that string.

> And why don't you at least symlink
> -rw-r--r-- 1 213402 2007-01-12 22:35
> /usr/share/doc/phpmyadmin/Documentation.html
> -rw-r--r-- 1 213402 2007-01-12 22:35
> /usr/share/phpmyadmin/Documentation.html
> to save file space?

> But wait, first split that giant file into chapter files.
>
> We also see /usr/share/doc/phpmyadmin/changelog.gz is in
> /usr/share/phpmyadmin/ChangeLog.
>
> Indeed, don't duplicate things to /usr/share/doc/phpmyadmin. Instead
> just add a note there about the proper way to read them (via
> http://localhost/phpmyadmin/... , not file:///

Those sound reasonable. I'll see how I can improve the packaging after
Etch. (I've only recently adopted this package, and the package can surely
use some cleanup)

> By the way, Documentation.html lacks a section about day to day normal
> usage.
>
> For starters: login as root to control everything. Login a some mysql
> user just to control that users' stuff.
>
> There should be a tool tip balloon when host=%.
>
> Obviously there is a missing tutorial.

I'll take these issues up with upstream to see what extra documentation
can and should be provided.

> There ought to be a logout button not only on the home page. The fire
> alarm sounds. I must leave my terminal. Wikipedia has a logout button
> on every page. Not phpmyadmin...

It is. It's actually, very aptly, an "exit sign" located in the left bar.


Thijs


Reply via email to