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? ^^

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

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.

Both produce a 404:

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

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.

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

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.

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

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)

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

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.

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.)