fsharp / fsharp/fsharp.org

docs.fsharp.org?

Đang mở
#995 9 bình luận 0 reaction 0 người được giao Xem trên GitHub
Ngôn ngữ chính
TeX
Star
311
Fork
291
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

I've spoken with @ReedCopsey and if we like he can make the DNS changes needed to activate https://docs.fsharp.org

However we'd need to decide what docs can really go there. I'll write some notes about what I think makes sense, if someone wants to tackle this

The main docs for F# are the ones listed here: https://learn.microsoft.com/dotnet/fsharp/ and whose source is part of the .NET docs (https://github.com/dotnet/docs). Although relying on the .NET docs to host and publish the F# docs is a bit annoying (e.g. the Microsoft branding and advertising is frustrating), it's not realistic for the F# community to host all those docs instead. The real question is about the important docs that are "external" to the .NET docs and are in this org,

* [F# language specification](https://fsharp.org/specs/language-spec/) and proto markdown (https://github.com/fsharp/fslang-spec)
* [F# library reference](https://fsharp.github.io/fsharp-core-docs) with source at https://github.com/fsharp/fsharp-core-docs
* [F# RFCs](https://github.com/fsharp/fslang-design)
* [F# Compiler docs](https://github.com/fsharp/fsharp-compiler-docs)

The .NET docs site links to these. Do we want to move the first two to docs.fsharp.org URL?

To do this we would need a single repo https://github.com/fsharp/fsharp-docs that would contain the CNAME for the DNS entry and would combine the material in
* `docs.fsharp.org/spec` --> the material now at https://fsharp.org/specs/language-spec
* `docs.fsharp.org/spec/markdown` --> the material now at https://github.com/fsharp/fslang-spec
* `docs.fsharp.org/reference/...` --> the material now at https://fsharp.github.io/fsharp-core-docs
* `docs.fsharp.org/compiler/...` --> the material now at https://fsharp.github.io/fsharp-compiler-docs/
* the content at https://fsharp.github.io/fsharp-core-docs would all need to be replaced by deep redirects to docs.fsharp.org/reference/... There are a lot of links to that current site.

The front page `docs.fsharp.org` would minimally need a search experience, see search on https://fsharp.github.io/fsharp-core-docs/ for example. Other improvements would have to come my improving the tools `fsdocs` (https://fsprojects.github.io/FSharp.Formatting/) which would continue to be used to generate at least the core docs.

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.