Like this? https://docs.webfreak.org/getting-started/first-steps/

On Tue, Jan 31, 2023 at 11:25:02AM +1300, Richard (Rikki) Andrew Cattermole via Digitalmars-d-announce wrote:
> Like this? https://docs.webfreak.org/getting-started/first-steps/

Not bad!  Looks much more promising than the original page for sure.

Still ran into some issues though. The linked "recipes" page contains tables that are far too wide for the width of the text block, forcing me to have to scroll left and right to see the rest of the columns. This makes it very painful to use.  The Build Settings section, for example, has a table with overly-wide Name and Arguments column, such that the description is invisible. The table is so long that at first glance there's not even a scrollbar, leaving me wondering what's up with all that blank space in the page.  The description column is also far too narrow for the amount of text it contains; this makes it needlessly cramped and the table longer than necessary.

I realize this is a WIP, but still missing is a page that explains dub's operational model: what it does exactly, and how this relates to the basic config items.  The "DUB Reference" tab AFAIK still links to that 1-page infodump I referred to in my other post (or at least some version of it), so the points I raised still apply to that page.  Needs a lot more work before this is usable as the official reference.



T

-- 
Кто везде - тот нигде.

I've gone ahead and pinged Jan on this. They didn't receive much feedback when first announced :)

Part of the problem is dub in general didn't receive much work done on it for the better part of 10 years. It has speed up within the last couple of years :) The registry and with that docs hasn't had that attention put towards it yet though.

I'm horrible at writing documentation, so I'm not much help here sadly.

On Monday, 30 January 2023 at 20:51:59 UTC, Richard (Rikki) Andrew Cattermole wrote:

> It isn't. WebFreak has an on-going project to replace it.
>
> https://forum.dlang.org/post/ojoiwbcftqsxbsvivghz@forum.dlang.org
>
> https://docs.webfreak.org/

That's quite an improvement. Perhaps it should be announced again, because I don't remember seeing the original post.

On Tuesday, 31 January 2023 at 15:03:50 UTC, bachmeier wrote:
> On Monday, 30 January 2023 at 20:51:59 UTC, Richard (Rikki) Andrew Cattermole wrote:
>
>> It isn't. WebFreak has an on-going project to replace it.
>>
>> https://forum.dlang.org/post/ojoiwbcftqsxbsvivghz@forum.dlang.org
>>
>> https://docs.webfreak.org/
>
> That's quite an improvement. Perhaps it should be announced again, because I don't remember seeing the original post.

I already posted it twice on two separate dates and tried to bump them after some time too, I think there is just not much demand in improved DUB docs, people probably think it's kinda fine already.

However for newcomers I think it's very worthwhile to do more stuff on there.

On Tuesday, 31 January 2023 at 21:14:04 UTC, WebFreak001 wrote:
> On Tuesday, 31 January 2023 at 15:03:50 UTC, bachmeier wrote:
>> On Monday, 30 January 2023 at 20:51:59 UTC, Richard (Rikki) Andrew Cattermole wrote:
>>
>>> It isn't. WebFreak has an on-going project to replace it.
>>>
>>> https://forum.dlang.org/post/ojoiwbcftqsxbsvivghz@forum.dlang.org
>>>
>>> https://docs.webfreak.org/
>>
>> That's quite an improvement. Perhaps it should be announced again, because I don't remember seeing the original post.
>
> I already posted it twice on two separate dates and tried to bump them after some time too, I think there is just not much demand in improved DUB docs, people probably think it's kinda fine already.
>
> However for newcomers I think it's very worthwhile to do more stuff on there.

I'll try writing recipe projects in future as dub examples. Although I'm nearly dropping dub in favor of my own build system, I think I've already played a lot into writing different kind of projects with different use-cases, such as using optional dependencies, building for various platforms, using custom runtimes. From the projects I've seen on dub.pm I think most usually only stick to the basics which is acceptable for small projects

On Thursday, 26 January 2023 at 14:31:55 UTC, Adam D Ruppe wrote:
> I did see the menus popped up in the wrong place though

That at least should be fixed now.

On Friday, 3 February 2023 at 08:30:55 UTC, Johann Lermer wrote:
> That at least should be fixed now.

Confirmed, works here now!

BTW I did `time make -j6` this time and it said 10 seconds, so still think the dmd -i approach better but if your incremental builds are smaller it might be better, I did git pull so of course that meant a lot of things were changed anyway.

On Friday, 3 February 2023 at 21:05:36 UTC, Adam D Ruppe wrote:

> BTW I did `time make -j6` this time and it said 10 seconds, so still think the dmd -i approach better but if your incremental builds are smaller it might be better, I did git pull so of course that meant a lot of things were changed anyway.

I tried -i as well but ran into a problem with X11 functions that are not defined (I didn't convert every X11 header to D and obviously some dependency  is missing - maybe I converted too much for my purpose. I just wonder that you did't run into the same problem. Mysterious...) so for the time being I'd like to focus more on the program than on the build system. But it's only delayed, not forgotten.

Btw. about the C libraries, I also tried using the new C header import but failed quite miserably - too many errors with macros and so on. So that is delayed as well.