> Comments on the Help chm; > I think there are too many colours. The help manual is a daily > workhorse, with blue, orange brown etc it becomes a little too > busy and hard on the eyes. > > I also think it would be better to display the background image > less, say only on the main heading pages (rather than on every page, > even the function description detail pages).
That background image will gone, as others reported that it is awful (and they were right :). > I like the faint light blue/grey background, better on the eyes > than white. This was the intention of it :) > I would like to see the "See also" section move to the top of the page > so that is added to the bullet items, so they become; > Purpose: > Usage: > Availability: > See also: > > I often find that it is when I read the first few lines of the description > and decide that this was not the function I wanted, that I need to immediately > see the "See also" items so I can go off to the function I really wanted. See also sections are sometimes placed in the text flow. Maybe we can implement some tags in the XML source to express this see also type you would like to see. There were some discussions about implementing such thing, so other formats can also benefit from the separation of see also blocks. To move up the see also list, we need to conceptually change the way we treat see also lists, so it is not likely we can do this in a short time (although one of the goals of this new CHM is to show how many things can be using the current manual content as input). > Previous, Next, Home and Up links are missing. I like these. Whenever I use > a function from a package that I have not used before I like to scan through > every function to familiarize myself with the package. The Next link > is great for this. I myself also missed these links. It was interesting, that noone reported these links as missing ones. I used next so often :)) But I can't think of any good place in the current design where it would be appropriate to put them... > PHP is a great language, the existing Help system is excellent. Your > efforts will make the Help system AWESOME! I hope we are on the right way to do this :) Goba
