Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos?

2018-01-24 Thread John Gabriele via Digitalmars-d-learn

On Tuesday, 23 January 2018 at 19:05:21 UTC, Seb wrote:

On Monday, 22 January 2018 at 19:38:45 UTC, John Gabriele wrote:
On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe 
wrote:

On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote:

Maybe it's due to historical reasons.


It's actually "future" reasons... the /phobos is the original 
one, and /library was supposed to replace it, but now many 
years later, /library is still kinda neglected and they both 
just exist.


What's needed to remove the "/phobos" one? Is it a decision 
from on-high, or is there a lot of editing of hardcoded links 
required?


This discussion and the referenced news group thread should 
give insights:


https://github.com/dlang/dlang.org/pull/1526



Thank you!



Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos?

2018-01-23 Thread Seb via Digitalmars-d-learn

On Monday, 22 January 2018 at 19:38:45 UTC, John Gabriele wrote:

On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe wrote:

On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote:

Maybe it's due to historical reasons.


It's actually "future" reasons... the /phobos is the original 
one, and /library was supposed to replace it, but now many 
years later, /library is still kinda neglected and they both 
just exist.


What's needed to remove the "/phobos" one? Is it a decision 
from on-high, or is there a lot of editing of hardcoded links 
required?


This discussion and the referenced news group thread should give 
insights:


https://github.com/dlang/dlang.org/pull/1526

BTW the fix for your issue is here:

https://github.com/dlang/phobos/pull/6055




Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos?

2018-01-22 Thread John Gabriele via Digitalmars-d-learn

On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe wrote:

On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote:

Maybe it's due to historical reasons.


It's actually "future" reasons... the /phobos is the original 
one, and /library was supposed to replace it, but now many 
years later, /library is still kinda neglected and they both 
just exist.


What's needed to remove the "/phobos" one? Is it a decision from 
on-high, or is there a lot of editing of hardcoded links required?


This is a reason why I forked the d docs to my site 
dpldocs.info. Check out its search:


http://dpldocs.info/writef

But yeah, the link in the original source is hardcoded for the 
/phobos path... but is also a relative link. So when generated 
on /library, it is just a 404. On my fork, I just fixed it, but 
/library tries to build from the master branch so they can't 
really just fix things without making sure it still works in 
both generators. what a mess.


I'm not sure I understand. What would it take to make the 
"/library" pages good enough that you wouldn't need 
?




Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos?

2018-01-22 Thread Adam D. Ruppe via Digitalmars-d-learn

On Monday, 22 January 2018 at 16:08:38 UTC, Johann wrote:
Not related to this thread, but is something missing from this 
page? Only "index" is shown on this page.


No, that's just a random file. If something isn't linked from 
another page, it isn't supported... I have a lot of files in that 
directory from various steps in my development process (it is 
still called "experimental" cuz it isn't done yet) and I haven't 
cleaned them all up.


Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos?

2018-01-22 Thread Johann via Digitalmars-d-learn

On Monday, 22 January 2018 at 15:32:29 UTC, Adam D. Ruppe wrote:


http://dpldocs.info/writef


Thanks for your good work. I will file a bug report then.

Not related to this thread, but is something missing from this 
page? Only "index" is shown on this page.


http://dpldocs.info/experimental-docs/




Re: [dlang library documentation] Why there are dlang.org/library and dlang.org/phobos?

2018-01-22 Thread Adam D. Ruppe via Digitalmars-d-learn

On Monday, 22 January 2018 at 15:18:38 UTC, Johann wrote:

Maybe it's due to historical reasons.


It's actually "future" reasons... the /phobos is the original 
one, and /library was supposed to replace it, but now many years 
later, /library is still kinda neglected and they both just exist.


This is a reason why I forked the d docs to my site dpldocs.info. 
Check out its search:


http://dpldocs.info/writef

But yeah, the link in the original source is hardcoded for the 
/phobos path... but is also a relative link. So when generated on 
/library, it is just a 404. On my fork, I just fixed it, but 
/library tries to build from the master branch so they can't 
really just fix things without making sure it still works in both 
generators. what a mess.


Or if both directories are intented to be used, I'll file a bug 
instead.


yeah that is prolly best