[Oh No! Page Not Found]

[dlangBugzillaToGithub]

Sinisa Susnjar reported this on 2023-09-29T10:15:39Z

Transferred from https://issues.dlang.org/show_bug.cgi?id=24170

Description

Hi, I got a page not found error when browsing the library docs here:

https://dlang.org/phobos/etc_valgrind_valgrind.html

[Prthmsh7]

@CyberShadow I was going through some simpler issues and maybe I can work on this one. Can you please take a look and tell which things i should be keeping in mind while working on this one and what references should I take from phobos and other resources. Ty

[CyberShadow]

Hi @Prthmsh7,

For this issue, I would suggest the following steps in getting it resolved:

1. Make sure you can build the website on your computer. There are instructions in the contributing guide:
   https://github.com/dlang/dlang.org/blob/master/CONTRIBUTING.md

2. In this situation, it looks like a part of the website is expecting a .html file to be generated, when it is not in fact being generated. We need to find out why this is.

   Some good places to start looking to understand the problem:

   1. The dlang.org Makefile, posix.mak. It contains rules to build various parts of the website.
   2. The source code for the module whose documentation .html file is missing: https://github.com/dlang/dmd/blob/master/druntime/src/etc/valgrind/valgrind.d
   3. The file lists used to build the runtime: https://github.com/dlang/dmd/tree/master/druntime/mak
   4. The runtime's Makefile, which contains rules (invoked by the dlang.org makefile) which use the file lists to build the documentation for the runtime: https://github.com/dlang/dmd/blob/master/druntime/Makefile

3. Once we understand why the .html file is not generated, we will need to create a solution which addresses this problem, but we can only do that once we understand the root cause.

[Prthmsh7]

Ohh, Thank you @CyberShadow for providing the resources, I've successfully built the website after on my local machine after following the steps that you referenced, and yes you're right, it's expecting a .html file to be generated, I'll try to understand why the file is not being generated and how we can fix it! Ty again

[Prthmsh7]

I think that we might be having some issue in DOCS file from our runtime, even though I'm not 100% sure, but here are some other files that are missing from our website aswell.
https://dlang.org/phobos/etc_c_odbc.html
https://dlang.org/phobos/etc_c_odbc_odbc32.html
https://dlang.org/phobos/etc_c_odbc_odbc64.html