http://api.haxe.org has gone offline, presumably since the last commit

https://api.haxe.org//highlighter.js

I'm getting a 404 there:

404 Not Found

    Code: NoSuchKey
    Message: The specified key does not exist.
    Key: /highlighter.js
    RequestId: 7G3HWMZY6KMF00N7
    HostId: OrwSrzeLnjBb2joxDl4jSKubbcUB5lTaGif+OrWnSIvwVkr/Tzq7rfH3YCy8+5ciAonZeLzZYd0=

Which triggers "Loading failed for the <script> with source “https://api.haxe.org//highlighter.js”." error and breaks the top menu (can't select version there).

Notice the double / there; link seems fine with a single / 🤔

Clicking on version dropdown

just refreshes the page. I expect it to open dropwdown.

I found that api.haxe.org isnt generated anymore, because there is an error.

https://travis-ci.org/github/HaxeFoundation/api.haxe.org/builds/749866906

Parsing /home/travis/build/HaxeFoundation/api.haxe.org/xml/find_file_cleanup/cs.xml
Parsing /home/travis/build/HaxeFoundation/api.haxe.org/xml/find_file_cleanup/php.xml
Error : Incompatibilities between haxe._Unserializer.FastString in cs and php (could not merge definition)
The command "neko Gen.n" exited with 255.

Tips from Slack:

Someone: Hm... I thought private API shouldn't affect doc gen
Someone else: there's an --include-private CLI flag, so private stuff may be needed. plus @:dox(show)
Another someone else: maybe import String as FastString; will do the trick? ^^

on https://api.haxe.org/Sys.html#command

Read the sys.io.Process api for a more complete way to start background processes.

sys.io.Process is linked to: https://api.haxe.org/lua/lib/luv/Process.html#Process

should probably be: https://api.haxe.org/sys/io/Process.html

Can we use a stable Haxe version for generating the api docs?

Because api.haxe.org was broken yesterday because of unicode related issues in Haxe development branch.

The repo is increasing with few mb per change on xml / theme change.

I suggest to reset history of the gh-branch on each deploy, unless there is a reason we want to keep the history.

Clicked on haxe.Constraints on this page https://api.haxe.org/haxe/Constructible.html to see what other constraints are available and it goes to a 404

https://api.haxe.org/haxe/Constraints.html

Incompatibilities between haxe._Unserializer.FastString in cs and php (could not merge definition)
looks like it's for the linux-ci-investigation branch tho, maybe we should delete that one

I run all commands from travis:

haxelib install all --always
haxelib dev hxparse libs/hxparse
haxelib dev hxtemplo libs/hxtemplo
haxelib dev hxargs libs/hxargs
haxelib dev markdown libs/haxe-markdown
haxelib dev dox libs/dox
haxe gen.hxml
neko Gen.n

Then I got this error:

C:\xxx\api.haxe.org>neko Gen.n run: haxe [--cwd,libs/dox,-lib,hxtemplo,-lib,hxparse,-lib,hxargs,-lib,markdown,-cp,src,-dce,no,--run,dox.Dox,-theme,C:/xxx/api.haxe.org/theme,--title,Haxe 3.2.1 API,-D,website,https://haxe.org/,-D,version,3.2.1,-D,source-path,https://github.com/HaxeFoundation/haxe/blob/3.2.1/std/,-i,C:/xxx/api.haxe.org/xml/3.2.1,-o,C:/xxx/api.haxe.org/html/v/3.2.1,-ex,microsoft,-ex,javax,-ex,cs.internal]
Type not found : dox.Dox

BTW, I think it's weird that libs/dox are empty, is that intented?

I think it might be related to the Haxe version it is using, since you do runCommand("haxe", args); in Gen? (I use Haxe 3.4.2)

Both produce a 404:

https://api.haxe.org/v/3.2.1/
https://api.haxe.org/v/3.3/

Was just looking at https://api.haxe.org/v/development/haxe/Utf8.html and noticed there was no deprecation notice for that class (https://github.com/HaxeFoundation/haxe/blob/b9df128719f0df33c86bf362c19b8a6599c7cfed/std/haxe/Utf8.hx#L29).

Went to look at dox and saw that it should include those notices since 2018 or so: HaxeFoundation/dox@6c36cce. (Unless I'm misunderstanding that commit.)

No license. I recommend CC-BY-SA 3.0/4.0 and CC0/MIT for code samples
For documentation, add "LICENSE" or "COPYING" file and add text of the CC-BY-SA text (for 3.0, for 4.0) or the following text:
This work (except for code samples, which are licensed under MIT/CC0 license) is licensed under the Creative Commons Attribution-ShareAlike 3.0/4.0 license. You can find copy of the CC-BY-SA here: https://creativecommons.org/licenses/by-sa/3.0/ / https://creativecommons.org/licenses/by-sa/4.0/
For code, just create "LICENSE-CODE" and add MIT/CC0 license text.

Haxe Manual is licensed under CC-BY, so it's recommended to use it instead of CC-BY-SA. Just change above links.

There are many temp haxe branches. Should detect which of them are removed and deleted the folders during CI.