fsharp / fsharp/fsharp.org

docs.fsharp.org?

Ouverte
#995 9 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
TeX
Étoiles
311
Forks
291
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

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.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Évaluation

Cette issue n'a pas encore été évaluée.

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.