Story on embedded resources seems to be rather outdated

[abelbraaksma]

In http://fsharp.github.io/2015/09/29/fsharp-compiler-guide.html#how-f-handles-embeddedresource-items-differently-to-c-details there's a long description about differences between how F# handles embedded resources. It links to several tracking issues, all of them resolved last year, one of them as won't fix.

I'm not quite sure which part of that story still apply, but at a minimum, I think someone knowledgeable about the subject could update it to contain the latest information. Maybe the whole section can be removed completely if the bugs in F# resource management have disappeared (with only a note saying the xBuild is not working properly).

Not sure this should be reported here, I'm happy to move it elsewhere if needed.

Relevant related issues:

• Non-ResX resources get different resource IDs on Windows compared to C# #922, fixed, I think via Make F# resources work more like C# fsharp/fsharp#761, but if it is a 100% fix I cannot tell
• [XBuild] ResX resources in sub-directories are missing the directory name  fsharp/fsharp#562, not fixed for xbuild, quote from @dsyme:

  A workaround is to use msbuild on Linux (xbuild is basically being deprecated slowly).

• Build support ignores LogicalName on EmbeddedResource items #1050, fixed via Make F# resources work more like C# #3352

[cartermp]

cc @dsyme to update that section

[cartermp]

Closing this as external