MicrosoftDocs / visualfsharpdocs

Frozen documentation repository for legacy MSDN Content for Visual F#
https://msdn.microsoft.com/en-us/visualfsharpdocs/conceptual/visual-fsharp
Creative Commons Attribution 4.0 International
102 stars 110 forks source link

Build on macOS/Linux broken #306

Closed stroborobo closed 3 years ago

stroborobo commented 6 years ago

Hey Team!

Do you think it'd be possible to get this to build on non-Windows systems?

I wanted to build a Dash docset for F#, but cannot build the HTML on my machine. I've modified the (downloaded) .openpublishing.buildcore.ps1 locally to use Mono's nuget and build paths using Join-Path instead of string literals, but I'm not done yet and don't know if there'll be a mayor barrier soon.

Or is there a HTML already for download somewhere? I mean self-contained of course.

josselinauguste commented 6 years ago

@stroborobo have you made any progress in your attempt to build a dash docset for this documentation? I was planning to do the same

stroborobo commented 6 years ago

No, I kinda dropped it tbh. But an easier way than getting it to build would have been to just replace the custom markdown directives for the snippets ([!code-fsharp[Main](path/to/snippet)) with their content, rewrite some links (because case sensitivity is hard apparently) and then it's good for indexing and rendering I guess. Styles would still be missing of course though.

There's not going to be any updates to this repo anymore, so we'll just have to use what we have. The new repo doesn't contain the F# Core lib yet, or does it?

It's still on my list, but I'm quite busy and easily distracted these days, so no promises :)

mairaw commented 6 years ago

Not sure if the instructions for building the .NET docs are still working, but you could give it a try: https://github.com/dotnet/docs/blob/master/CONTRIBUTING.md#building-the-docs

josselinauguste commented 6 years ago

I can't build neither of the documentations :/

I'll start by trying to confirm with anyone involved in the documentation maintenance that the VisualFSharp documentation will actually migrate soon to the dotnet/docs repository, so I'll not have to do the job twice. To be continued...

mairaw commented 6 years ago

@cartermp @dend do you guys know?

dend commented 6 years ago

Hi folks,

We will be decommissioning the documentation in this repo once we fully migrate content to the dotnet/docs repo. We are currently in the process of doing so.

Den

josselinauguste commented 6 years ago

Great, so I'll wait for the documentation to be fully migrated :-)

stroborobo commented 6 years ago

@josselinauguste It's not finished yet, but here's where I am right now: https://github.com/foobarius1/fsharp-docset

After the recent HN thread about live coding via stream I thought I'd start streaming myself learning F#. This is both my first personal F# project and my first stream: https://www.twitch.tv/events/RUdNKTi_QWSHYVzZljnFtg

josselinauguste commented 6 years ago

@stroborobo awesome idea! I'll have a look at it, ping me if you need some help 👍

josselinauguste commented 5 years ago

@dend Any news about the decommissioning of this documentation?

mairaw commented 5 years ago

I just sent an e-mail to the team asking about this today. @dendeli-msft can you comment?

stroborobo commented 5 years ago

Strangely none of the actual API docs from this repo seem to have been migrated. Or did I just not find it? E.g. Seq.fold is only mentioned as a link to the deployment of this repo.