perlang.org: API docs are currently missing

perlun commented 2 years ago

As reported by Simon Byholm (thanks!), the API docs on https://perlang.org/api/index.html are currently completely missing. I first thought this was a mobile-only bug, but they are completely gone. This issue will be used to hunt down and eventually fix this issue.

Evidence thus far

https://github.com/perlang-org/perlang.org/commit/16ec436e4f9f4b07dec8d30e74fea90daa48613f seems to be the first commit in the perlang.org repo where the public/api directory lacks content.
This in turn seems to be generated from https://github.com/perlang-org/perlang/commit/33207606f8c4d05f3847f90792938a90260d5e59, i.e. #337. The MR didn't change anything documentation-related in particular. :thinking:

perlun commented 2 years ago

Managed to reproduce this locally now. With my existing checkout, it worked (the API docs were correctly generated). However, with a clean repo checkout, I actually get the exact same behavior:

[22:02:04] per@delorean:~/git/perlang2 (master) $ ls -l _site/
total 180
drwxr-xr-x 3 per per  4096 sep 21 22:02 about
drwxr-xr-x 2 per per  4096 sep 21 22:02 api
drwxr-xr-x 2 per per  4096 sep 21 22:02 casts
drwxr-xr-x 2 per per  4096 sep 21 22:02 contribute
drwxr-xr-x 2 per per  4096 sep 21 22:02 download
-rw-r--r-- 1 per per 99678 sep 21 22:02 favicon.ico
drwxr-xr-x 2 per per  4096 sep 21 22:02 fonts
-rw-r--r-- 1 per per  7888 sep 21 22:02 index.html
drwxr-xr-x 2 per per  4096 sep 21 22:02 js
drwxr-xr-x 4 per per  4096 sep 21 22:02 learn
-rw-r--r-- 1 per per  1297 sep 21 22:02 logo.svg
-rw-r--r-- 1 per per  6888 sep 21 22:02 manifest.json
-rw-r--r-- 1 per per  1271 sep 21 22:02 search-stopwords.json
drwxr-xr-x 2 per per  4096 sep 21 22:02 styles
-rw-r--r-- 1 per per  9407 sep 21 22:02 syntax-grammar.html
-rw-r--r-- 1 per per  1422 sep 21 22:02 toc.html
-rw-r--r-- 1 per per    49 sep 21 22:02 xrefmap.yml
[22:02:06] per@delorean:~/git/perlang2 (master) $ ls -l _site/api/
total 8
-rw-r--r-- 1 per per 4951 sep 21 22:02 index.html

perlun commented 2 years ago

Hmm, I guess it could be these that makes the difference. :thinking: From my working checkout, it looks like this:

[22:05:12] per@delorean:~/git/perlang (master) $ ls -l docs/api/
total 100
-rw-r--r-- 1 per per   452 feb 26  2022 index.md
-rw-r--r-- 1 per per  5277 sep 21 21:53 Perlang.ConsoleApp.CommandResultExtensions.yml
-rw-r--r-- 1 per per  5669 sep 21 21:53 Perlang.ConsoleApp.Program.yml
-rw-r--r-- 1 per per   778 sep 21 21:53 Perlang.ConsoleApp.yml
-rw-r--r-- 1 per per  3681 sep 21 21:53 Perlang.Exceptions.IllegalStateException.yml
-rw-r--r-- 1 per per  3353 sep 21 21:53 Perlang.Exceptions.StdlibException.yml
-rw-r--r-- 1 per per  1003 sep 21 21:53 Perlang.Exceptions.yml
-rw-r--r-- 1 per per  6633 sep 21 21:53 Perlang.Stdlib.Argv.yml
-rw-r--r-- 1 per per  4305 sep 21 21:53 Perlang.Stdlib.Base64.yml
-rw-r--r-- 1 per per 18729 sep 21 21:53 Perlang.Stdlib.Libc.yml
-rw-r--r-- 1 per per 13656 sep 21 21:53 Perlang.Stdlib.Posix.yml
-rw-r--r-- 1 per per  2066 sep 21 21:53 Perlang.Stdlib.Time.yml
-rw-r--r-- 1 per per  1071 sep 21 21:53 Perlang.Stdlib.yml
-rw-r--r-- 1 per per   724 sep 21 21:53 toc.yml

In my new checkout, these files are completely missing. So where on earth do they come from?? :grimacing:

perlun commented 2 years ago

Hmm... I might be on to something now. The working repo has files like this in place:

[22:13:43] per@delorean:~/git/perlang (master) $ ls -l src/Perlang.Common/obj/xdoc/cache/obj/
total 17392
-rw-r--r-- 1 per per 546113 feb  8  2022 23b2qod5.jyq
-rw-r--r-- 1 per per 548102 feb  3  2022 2fupekv9.3d7
-rw-r--r-- 1 per per 516950 sep  1  2021 2jlapc0l.r98
-rw-r--r-- 1 per per 548102 feb  3  2022 2x9oenhe.crt
-rw-r--r-- 1 per per 515049 apr 16  2021 350weunn.wri
-rw-r--r-- 1 per per 544949 feb  3  2022 3612mt2a.xhh
-rw-r--r-- 1 per per 507349 mar 12  2021 3elmsw85.0h3
-rw-r--r-- 1 per per 551905 mar  7  2022 5dlszv3r.u58
-rw-r--r-- 1 per per 516950 sep  1  2021 5urt88y7.ge4
-rw-r--r-- 1 per per 544949 feb  3  2022 82f70uat.zf0
-rw-r--r-- 1 per per 544949 feb  3  2022 8mflpwkf.q8m
-rw-r--r-- 1 per per 518899 mar 17  2021 9o3zb8cu.93n
-rw-r--r-- 1 per per 548102 feb  3  2022 avixjntx.eeb
-rw-r--r-- 1 per per 516932 maj 13  2021 b7qtgqr2.hw0
-rw-r--r-- 1 per per 546113 feb 12  2022 ds2y4utc.a6v
-rw-r--r-- 1 per per 516932 maj 17  2021 e377cno4.297
-rw-r--r-- 1 per per 548102 feb  3  2022 gqgac2pq.2t7
-rw-r--r-- 1 per per 544949 feb  5  2022 h4yfzqhn.7hn
-rw-r--r-- 1 per per 515139 apr 16  2021 ilv6xnky.tk3
-rw-r--r-- 1 per per 547817 feb 17  2022 l46df0qf.cdc
-rw-r--r-- 1 per per 548102 feb  3  2022 nihgc5b7.iuv
-rw-r--r-- 1 per per 516950 aug  6  2021 opnrv6ss.6gv
-rw-r--r-- 1 per per 548102 feb  3  2022 pzrbg803.vxy
-rw-r--r-- 1 per per 548102 feb  3  2022 qj1fypqg.pp9
-rw-r--r-- 1 per per 544949 feb  3  2022 qqp09jss.4gv
-rw-r--r-- 1 per per 544949 feb  3  2022 qqut4syz.i30
-rw-r--r-- 1 per per 548102 feb  3  2022 qvihvr37.rlw
-rw-r--r-- 1 per per 547817 feb 14  2022 rq0qg3xe.iks
-rw-r--r-- 1 per per 513764 apr 16  2021 soutklzc.o7r
-rw-r--r-- 1 per per 548102 feb  3  2022 temprs11.nf9
-rw-r--r-- 1 per per 544949 feb  3  2022 tev4msps.jho
-rw-r--r-- 1 per per    163 sep 21 21:53 xd1gzzps.1jq
-rw-r--r-- 1 per per 548102 feb  3  2022 ygsdvbwq.gii
-rw-r--r-- 1 per per 548102 feb  3  2022 yu2jpjgc.cgy

The new directory has some of this, but much less content. I guess this is some kind of tempfile used by DocFX...

[22:14:19] per@delorean:~/git/perlang (master) $ ls -l ../perlang2/src/Perlang.Common/obj/xdoc/cache/obj/
total 4
-rw-r--r-- 1 per per 163 sep 21 22:02 53tz3yqx.7ce

perlun commented 2 years ago

We're getting there, slowly but steadily.

In the working repo

[22:24:52] per@delorean:~/git/perlang (master) $ ./docfx/docfx.exe metadata docs/docfx.json
[22-09-21 07:24:53.308]Info:[ExtractMetadata]Using mono /usr/lib/mono/msbuild/15.0/bin/MSBuild.dll as inner compiler.
[22-09-21 07:24:53.421]Info:[ExtractMetadata]Loading projects...
[22-09-21 07:24:53.871]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:53.953]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:53.998]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.033]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.069]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.110]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.144]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.177]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.178]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj' does not contain any documents.
[22-09-21 07:24:54.180]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' does not contain any documents.
[22-09-21 07:24:54.180]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj' does not contain any documents.
[22-09-21 07:24:54.180]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj' does not contain any documents.
[22-09-21 07:24:54.180]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' does not contain any documents.
[22-09-21 07:24:54.180]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' does not contain any documents.
[22-09-21 07:24:54.180]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj' does not contain any documents.
[22-09-21 07:24:54.180]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj' does not contain any documents.
[22-09-21 07:24:54.196]Info:[ExtractMetadata]'/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj,/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj,/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj,/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj,/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj,/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj,/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj,/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj' keep up-to-date since '9/21/2022 6:53:07 PM', cached result from '/home/per/git/perlang/docs/api' is used.
[22-09-21 07:24:54.198]Info:Completed in 903.9874 milliseconds

Build succeeded with warning.
[22-09-21 07:24:54.199]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.199]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.199]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.200]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.200]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.200]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.200]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.200]Warning:[ExtractMetadata](/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj' does not contain any documents.
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' does not contain any documents.
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj' does not contain any documents.
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj' does not contain any documents.
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' does not contain any documents.
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' does not contain any documents.
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj' does not contain any documents.
[22-09-21 07:24:54.200]Warning:[ExtractMetadata]Project '/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj' does not contain any documents.
    16 Warning(s)
    0 Error(s)

I think this is the key line; it's not present in the "broken" output:

[22-09-21 07:24:54.196]Info:[ExtractMetadata]'/home/per/git/perlang/src/Perlang.Stdlib/Perlang.Stdlib.csproj,/home/per/git/perlang/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj,/home/per/git/perlang/src/Perlang.Tests/Perlang.Tests.csproj,/home/per/git/perlang/src/Perlang.Common/Perlang.Common.csproj,/home/per/git/perlang/src/Perlang.Interpreter/Perlang.Interpreter.csproj,/home/per/git/perlang/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj,/home/per/git/perlang/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj,/home/per/git/perlang/src/Perlang.Parser/Perlang.Parser.csproj' keep up-to-date since '9/21/2022 6:53:07 PM', cached result from '/home/per/git/perlang/docs/api' is used.

In the broken repo

[22:23:21] per@delorean:~/git/perlang2 (master) $ ./docfx/docfx.exe metadata docs/docfx.json
[22-09-21 07:23:55.170]Info:[ExtractMetadata]Using mono /usr/lib/mono/msbuild/15.0/bin/MSBuild.dll as inner compiler.
[22-09-21 07:23:55.257]Info:[ExtractMetadata]Loading projects...
[22-09-21 07:23:55.708]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:55.784]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:55.824]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:55.857]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:55.893]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:55.936]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:55.973]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.010]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.012]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj' does not contain any documents.
[22-09-21 07:23:56.013]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' does not contain any documents.
[22-09-21 07:23:56.013]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj' does not contain any documents.
[22-09-21 07:23:56.013]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj' does not contain any documents.
[22-09-21 07:23:56.013]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj' does not contain any documents.
[22-09-21 07:23:56.013]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj' does not contain any documents.
[22-09-21 07:23:56.013]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' does not contain any documents.
[22-09-21 07:23:56.013]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' does not contain any documents.
[22-09-21 07:23:56.023]Info:[ExtractMetadata]Cache for /home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj,/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj,/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj,/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj,/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj,/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj,/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj,/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj in /home/per/git/perlang2/src/Perlang.Common/obj/xdoc/cache/final/599273084 is corrupted, rebuild...
[22-09-21 07:23:56.023]Info:[ExtractMetadata]Generating metadata for each project...
[22-09-21 07:23:56.078]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.Tests/obj/xdoc/cache/obj/en8v53an.f49' is used.
[22-09-21 07:23:56.104]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.ConsoleApp/obj/xdoc/cache/obj/953my6w0.g9j' is used.
[22-09-21 07:23:56.104]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.Common/obj/xdoc/cache/obj/53tz3yqx.7ce' is used.
[22-09-21 07:23:56.105]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.Parser/obj/xdoc/cache/obj/080jlt9d.0k1' is used.
[22-09-21 07:23:56.105]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.Interpreter/obj/xdoc/cache/obj/lc22dn3n.3hk' is used.
[22-09-21 07:23:56.105]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.Stdlib/obj/xdoc/cache/obj/inwbinky.h0z' is used.
[22-09-21 07:23:56.106]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.Tests.Architecture/obj/xdoc/cache/obj/zxc5es8f.zpr' is used.
[22-09-21 07:23:56.106]Info:[ExtractMetadata]'/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' keep up-to-date since '9/21/2022 7:02:03 PM', cached intermediate result '/home/per/git/perlang2/src/Perlang.Tests.Integration/obj/xdoc/cache/obj/aw0zkunl.e0q' is used.
[22-09-21 07:23:56.107]Warning:[ExtractMetadata]No metadata is generated for Perlang.Tests,Perlang.ConsoleApp,Perlang.Common,Perlang.Parser,Perlang.Interpreter,Perlang.Stdlib,Perlang.Tests.Architecture,Perlang.Tests.Integration.
[22-09-21 07:23:56.115]Info:Completed in 959.2064 milliseconds

Build succeeded with warning.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata](/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj)Workspace failed with: [Failure] Msbuild failed when processing the file '/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj' with message: Method not found: System.Collections.Immutable.ImmutableList`1<!!0> System.Collections.Immutable.ImmutableList.ToImmutableList<!0>(System.Collections.Immutable.ImmutableList`1/Builder<!!0>)
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Tests/Perlang.Tests.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.ConsoleApp/Perlang.ConsoleApp.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Common/Perlang.Common.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Parser/Perlang.Parser.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Interpreter/Perlang.Interpreter.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Stdlib/Perlang.Stdlib.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Tests.Architecture/Perlang.Tests.Architecture.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]Project '/home/per/git/perlang2/src/Perlang.Tests.Integration/Perlang.Tests.Integration.csproj' does not contain any documents.
[22-09-21 07:23:56.117]Warning:[ExtractMetadata]No metadata is generated for Perlang.Tests,Perlang.ConsoleApp,Perlang.Common,Perlang.Parser,Perlang.Interpreter,Perlang.Stdlib,Perlang.Tests.Architecture,Perlang.Tests.Integration.
    17 Warning(s)
    0 Error(s)

Obviously, having a boatload of warnings like this is never good since it can definitely obscure important parts of the output. (In other words, we should aim for resolving #186 as soon as possible).

perlun commented 2 years ago

Two mitigations have been taken so far; the root cause has not been found though:

The latest commit in https://github.com/perlang-org/perlang.org has been dropped (in which the API docs was removed) and the second-latest commit was amended, to force a new CI run. This means that https://perlang.org/api/index.html is now operational again. :tada:
A PR to ensure that errors like this are caught in CI was made: https://github.com/perlang-org/perlang/pull/345. This aims to prevent similar regressions in the future.
- This CI job illustrates what it looks like when the error check fails (as with our current master code base): https://github.com/perlang-org/perlang/actions/runs/3107820419/jobs/5036344706

perlang-org / perlang