Fix gtkD api display

Mike Wey via Digitalmars-d-learn digitalmars-d-learn at puremagic.com
Fri Aug 4 08:08:27 PDT 2017


On 04-08-17 03:51, Johnson Jones wrote:
> https://api.gtkd.org
> 
> It is difficult to navigate.
> 
> 1. clicking the documentation on the main site takes it to the 
> gtk.AboutDialog api. That is all it shows, I was confused at first, as 
> I'm sure most people would be.
> 
> 2. The packages list lists all the packages, but all the sub elements 
> are expanded, making it time consuming to hunt down anything specific. 
> Initially collapsing them and adding a search box would be nice.
> 
> 3. When clicking on any packages it reloads the page and shows only the 
> package in the first tab. This requires one to then go back to packages 
> and hunt for something else again. Because the position of the scroll is 
> not saved, one has to scroll down through the entire list.
> 
> It would be better, I think, if it was one single tab all in a single 
> hierarchy that never reloaded the page so that it is easier to navigate 
> quickly.
> 
> e.g.,
> 
> instead of
> 
> Package
> atk
>    atk.ActionIF
>    atk.Action
>    ...
> 
> we have
> 
> atk
>    atk.ActionIF
>       GetActionStruct
>       GetStruct
>       ...
>    atk.Action
>       ...
> ...
> 
> 
> and so effectually combining both tabs. It should solve the issues that 
> the current way has without really causing any problems. Everything 
> should be collapsed by default and since no reloading of the page should 
> occur(which might require having the api descriptions in a separate 
> frame that is loaded separately on package changes to avoid reloading 
> the tree view which will recollapse everything).
> 
> It will make navigating the gtkD api much more fun ;)

Improving the documentation is something i want to do but there are 
always some more important things to do. Like the Questions/Issues you 
posted earlier.

So unless somebody volunteers it won't happen anytime soon.

-- 
Mike Wey


More information about the Digitalmars-d-learn mailing list