safe-stack / docs Goto Github PK
View Code? Open in Web Editor NEWHome Page: https://safe-stack.github.io/docs/
License: MIT License
Home Page: https://safe-stack.github.io/docs/
License: MIT License
The doc for Docker deployment references a Deploy target in release.cmd, but this target does not exist in build.fsx.
I've just realised that for a long time now the travis builds are actually failing https://travis-ci.com/github/SAFE-Stack/docs/builds
Explain what it is and where it can be used.
Currently I am using material-ui as layout for in a SAFE template setup. Is it possible to add this ui lib as an alternative option to Fulma?
We receive many issues about not working links, e.g. #187 #189 #191
If you look at how we create the links - sometimes it's an absolute and sometimes it's a relative reference.
We should use one single, normalised convention for the links and ideally automate checking that none of the links are "dead"
This is a tentative list of "recipes" or "how-to" guides that the docs should offer. Hopefully each should be relatively small and quick to author!
the links to fulma templates are 404 ing on the template overview page :
none: don't add any CSS framework.
fulma-basic: adds Fulma basic template (default).
fulma-admin: adds Fulma with the 'Admin' Bulma template.
fulma-cover: adds Fulma with the 'Cover' Bulma template.
fulma-hero: adds Fulma with the 'Hero' Bulma template.
fulma-landing: adds Fulma with the 'Landing' Bulma template.
fulma-login: adds Fulma with the 'Login' Bulma template.
In the hot reload recipe it says that you need to add the devServer to the webpack.config.js for the minimal template, this is not true. The devServer is already configured.
If you start at https://safe-stack.github.io/ and click Read the Documentation, and click Next two times, you end up on at SAFE Stack components, which tells you "S" is for Saturn.
But if you go back to https://safe-stack.github.io/ and click Read More About Safe, you end up at an announcement, which says that "S" is for Suave.
My guess is that the confusion is caused by an announcement that has become out of date. Either it should be updated, or the Read More About Safe link should point to a living page, rather than a fixed blog post.
Hello,
just tried to deploy a quick start project to IIS using AspNetCoreModule (but I have to say that HttpPlatformHandler yelds the same results).
Project has been published as a framework-independent app which means that the whole .NET Core Framework gets published to support server where .NET Core hosting bundle had not previously installed.
So basically you create an image to publish like this:
dotnet publish --self-contained -r win-x64
That has been moved to server which is actually using Windows Azure Pack which is something similar to Azure AppService (in facts, I believe they are the same technology).
web.config file has been configured like this:
`
<system.webServer>
<handlers>
<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
</handlers>
<aspNetCore processPath=".\Server.exe" stdoutLogEnabled="true" stdoutLogFile=".\stdout.txt" />
</system.webServer>
`
So what it seem to happen is that server.exe starts and IIS proxies request to the process but once it does that, 404 is returned for root (/) request.
It seems the process (and not IIS) is handling the requests and returning a 404 as pet AspNetCoreModule log file.
'
info: Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager[0]
Azure Web Sites environment detected. Using 'C:\home\ASP.NET\DataProtection-Keys' as key repository; keys will not be encrypted at rest.
Hosting environment: Production
Content root path: C:\home\site\wwwroot
Now listening on: http://127.0.0.1:30146
Application started. Press Ctrl+C to shut down.
info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
Request starting HTTP/1.1 GET http://safedemo.eu-w.cloudapps.enterprisehost.biz/
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
Request finished in 67.5888ms 404
info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
Request starting HTTP/1.1 GET http://safedemo.eu-w.cloudapps.enterprisehost.biz/favicon.ico
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
Request finished in 1.7730000000000001ms 404
'
Any hint ? Onto the file system contents of the server folder has been published to wwwroot folder while Shared and Client have been placed into the appropriate parent folder to the actual file system layout is:
C:\home\site\Client <---- Client folder contents here
C:\home\site\Shared <---- Shared folder contents here
C:\home\site\wwwroot <---- Server folder contents here
Any hint ?
Thanks.
@theimowski I've had a look, seems that it happened a month ago or so... any idea what happened? I can't figure it out, something about a missing svg icon?
Currently links to a 404 page since Fulma moved repos:
https://mangelmaxime.github.io/Fulma
Should link to:
https://fulma.github.io/Fulma/
Start a list of websites/projects that use fable. This can show some places where fable is used in production. This would be useful for: introducing people to SAFE Stack; learning, especially in the case of open-source projects; and seeing what kind of things the community is using Fable for, especially for closed-source websites that can't be found by searching GitHub.
My thoughts are:
This list should ideally feature "real world" sites that use F# for a non-trivial part of the front-end. Demos like SAFE Search and documentation sites built with Fable such as the Feliz docs may still be useful to include in a section but should not be the focus.
Each listing should include a name, link, and a brief description of the extent that F# is used on the front-end and whether F# is also used on the back-end, if applicable.
When trying to read the recipe for migrating to paket, Migrate to Paket, the link is not valid.
On this page, there is a section dedicated to Handling "unit" calls
.
Today, I released a new versions of Thoth.Json(.Net) which add support for unit
. Could someone from the SAFE stack test it and see if it's working correctly?
If yes, then we should add a mention that since Thoth.Json 3.4.0
and Thoth.Json.Net 3.6.0
users can now use unit
in their server response.
Would be nice if pushing to master triggered automatic deployment to gh-pages
Currently the documentation uses the legacy application registration within Azure AD but there is no mention that you should use the legacy creation flow. We have 2 options for how to fix this
App Registration (Legacy)
I've put a placeholder in for explaining what the FAKE script does in the SAFE-template. https://safe-stack.github.io/docs/template-fake/
@theimowski would you be interested in writing it up? If not I'll do it no prob.
I am observing Server side still uses .net core 3.0 which is obsolete by now.
A short article explaining the different elements of the webpack template would be very useful, similar to the FAKE script documentation that we already have.
Hey @theimowski!
It looks like for the last few merges into master the build has not been triggered since the Owner SAFE-Stack does not have enough credits.
Before that there seems to be an error of Abuse Detected
for the following PR - Added 'SQLProvider SQL Server SSDT' to the Data recipes
Resources:
If you need anything else please let me know :)
I apologise in advance this is probably the wrong repo for this suggestion
Is it possible to install the prerequisites with a package like:
choco install dotnetsafe
brew install dotnetsafe
apt install dotnetsafe
Feels like we could lower the first barrier to entry by doing so
Hey guys!
I've put together a list of pages on the SAFE documentation that will need to be updated/added for the latest template
Introduction(wording .net core -> .net)
Quick Start
SAFE Stack Overview
Components of SAFE
The SAFE Template
How do I...
Upgrade from V2 to V3
Build
Dev / Test
Client/Server
UI
Package Management
FAQ
Moving current docs into a Legacy V2 section (NEW)
Removing Legacy v1
Compare the generated sitemap with the current sitemap.xml
If I've missed something let me know :)
When you return a unit from the server, Thoth.Json gives you this error:
Cannot generate auto decoder for Microsoft.FSharp.Core.Unit. Please pass an extra decoder.
There are a couple of known workarounds, it would be nice to have these known exceptions documenten somewhere.
Going through the template now, just the following broken link.
Include this somewhere in the docs
On the website: https://safe-stack.github.io/docs/feature-clientserver-bridge/
In the second paragraph the links "stateful APIs in Saturn" and "model-view-update pattern" are broken both on the website and in the Markdown source.
The website links are pointing to sub-resources (e.g. docs/feature-clientserver-bridge/component-saturn
) instead of resources on the same level (e.g. docs/component-saturn
).
The Markdown links don't work without the .md
extension.
The previous commit seems to also be about broken links: 9edaf15
And this other issue: #158
I've installed the most recent version of the SAFE stack template, and tried to follow the instructions from the quick start: https://safe-stack.github.io/docs/quickstart/
I have npm installed, but not yarn. When I tried to run fake build --target run
, I received the following error:
Script reported an error:
-> yarn was not found in path. Please install it and make sure it's available from your path. See https://safe-stack.github.io/docs/quickstart/#install-pre-requisites for more info
After I installed yarn, it worked without issue. Should the language be changed to require yarn, instead of "yarn or npm"? If so, I'm happy to submit a PR.
Right now the docs says that there is an issue with the Suave license. From what I can gather from the discussion at SuaveIO/suave#704 it seems like there is no Suave licensing issue but rather something else. Perhaps writing that SAFE stack is focusing on .net core in order to not cause undue confusion.
There are a few broken links to a library called Elmish.Streams in the template overview page. I cant find any documentation or source of this library. Could it have been renamed to Fable.Reaction?
Clicking "next quick start" at the bottom of https://safe-stack.github.io/docs/intro/
Takes you to: https://safe-stack.github.io/docs/intro/quickstart/ which 404s instead of:
https://safe-stack.github.io/docs/quickstart/
It's not easily clear how to go from dev to prod with SAFE apps - in dev you normally use webpack-dev-server
to host the client but at deployment time you pre-compile the js and host in either the server as static content or some other way e.g. blob storage, function etc..
Discuss auth / security, explaining use of JWTs etc. and optionally Azure App Service turn-key auth.
https://safe-stack.github.io/docs/
The navigation bar at the bottom of each page is broken: arrow links always lead to a 404 Not Found page except when navigating from Home to Introduction.
I think I saw a question during fsharpconf about migration path from v1 to v2.
Although we don't really support "upgrading" story, we might give a short description what other aspects changed between v1 and v2
From https://safe-stack.github.io/docs/quickstart/
Enter dotnet tool restore to install local tools like FAKE.
We don't use the FAKE tool any more. I think just Paket is needed. FAKE as a dotnet tool should probably be removed.
Also the tool restore is only required once.
Hello,
As a newcomer to dotnet and F# ecosystem it would be very helpful if you added instructions on how to add dependencies to the project. Simply typing paket add PACKAGE
, which is the instructions on nuget, is not enough. You have to do paket add PACKAGE --project Server/Server.fsproj
for backend dependencies and paket add PACKAGE --project Client/Client.fsproj
for frontend.
Migrated from SAFE-Stack/SAFE-Stack.github.io#11
I've been looking at giving the website a refresh. I think that we have a few options:
Keeping the site is the cheapest option but we're going to need to add / remove a lot of content anyway once v2 of the template drops. I strongly think that the current landing page should be replaced, although this could just be a static page that we chuck in as a one-off.
What do people think? Is anyone available to support with this?
C:\C#Projects\SAFE-Stack\docs\docs>mkdocs serve
INFO - Building documentation...
INFO - Cleaning site directory
INFO - The following pages exist in the docs directory, but are not included in the "nav" configuration:
I am getting this error while running mkdocs serve command. Anybody knows why?
This is now outdated as of the latest SAFE template which uses Fable 2 and Thoth. I'm not even sure what the "correct" way to do this is.
fetchAs
in the docs with?cc: @MangelMaxime @theimowski @Krzysztof-Cieslak @alfonsogarciacaro.
I've temporarily disabled footer links until we fix this. cc: @theimowski
Is there any support or guidance on how to integrate all this great work with an electron client application?
Since the last upgrade, Fable.Remoting takes a different approach on raw http and makes it easier for clients other than the typed proxies (Fable or dotnet client) to talk to the server, please see the new docs and update the section to how you see fit ๐
Femto docs mention that step 2 (analyse dependencies) should run in the root directory. That is not the case, you should either be inside the Client directory to run femto
or point Femto to where the client directory is:
# Analyse dependencies
dotnet femto ./src/Client
# Resolve package requirements
dotnet femto ./src/Client --resolve
Please try it out locally to make sure it works too.
I just published Femto v0.8.7 and it should work ootb when instrumenting locally installed paket
Another thing to add if you working on the docs for Femto is to explain femto install
because it abstracts nuget/paket and does automatic resolution of potentially required npm package (you can even use it for the Server project)
Since the rename of the org happened: fable-elmish -> elmish
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.