fermyon / developer Goto Github PK
View Code? Open in Web Editor NEWThis is the home for developer.fermyon.com
Home Page: https://developer.fermyon.com
License: Apache License 2.0
This is the home for developer.fermyon.com
Home Page: https://developer.fermyon.com
License: Apache License 2.0
Trial accounts are restricted to 5 apps, and 1 channel per app, for example. These restrictions should be documented so that the user clearly knows what is the expected behaviour of the platform.
Consider the following code block that shows a shell command and its output:
The "copy" button will copy the entire contents, whereas the only thing you need is the command itself.
Is there a way we could have some logic (perhaps a shortcode?) where we could distinguish between a command and its output?
It would be brilliant to be able to link to headings instead of just being able to link to whole pages.
Not sure what this entails; need to have a quick research/look. Putting in this issue so we can make this happen soon.
The Redis examples do not have any of the use
statements in them, which means the reader has to go figure out which packages to use.
The static/image/arrowexternal.svg
icon is a temporary solution. We need a designed file for this, and the corresponding css/html.
Page templates and scripts to generate paths are currently duplicated per project/product. Let's see if this can be consolidated.
The Markdown linter currently fails because of an empty link as pointed out by the error
content/spin/architecture.md:61:47 MD042/no-empty-links No empty links [Context: "[pre-instantiate]()"]
I am unsure of the proper link that it needs to be pointing at.
Let's change the 'Fermyverse' name in the search box to "Fermyon Developer Home" to keep it consistent across the site.
First I want to thank you for putting out this programming language guide for Wasm and it helped me a lot to learn what PLs support WASI environment. When I first read the guide, I was confused about the "Other" column in the top 20 languages. I later figured it out it meant non-browser environments. But this is a bit vague. Do you mean host environments with an operating systems like Windows or Unix? I would recommend to make it more specific, probably by saying these languages could work in Linux OS.
Another note is that the "Wasm languages" and "Other Notable Languages" have a section where the "Other" column is replaced with "CLI". Does "CLI" mean the same thing as "Other" in the previous section?
Using a <details>
element does not render in a nice way, and you cannot use links inside the element.
You can now run spin using the command `./spin`
<details>
<summary>Learn more</summary>
The [Spin quickstart](https://developer.fermyon.com/spin/quickstart) is a good place to start, to learn more about Spin.
</details>
Renders like this
As we release this website and remove docs from the Spin repo, we should make sure that the links to the contribution guide and SIPs are updated in spin_sidebar.hbs
Forest functional programming language: https://github.com/forest-lang/forest-compiler
It would be really cool if the code renderer for our docs website allowed a toggle we can use to show instructions / code samples for multiple platforms / languages (like Linux and Windows instructions, or how to write a component in multiple programming languages).
This would be similar to:
(source: Cloud Run docs)
Broken links in developer portal as we are using /
at the end of href link even when it is pointing to a file.
e.g.
in templates/spin_sidebar.hbs
Steps to reproduce:
https://canary.developer.fermyon.com/
Spin
in top navigationin left navigation. Notice it takes you to
https://canary.developer.fermyon.com/spin/quickstart/` with a slash at the end.Rust
linkhttps://canary.developer.fermyon.com/spin/quickstart/rust-components
which is incorrect.Now if you just remove last /
from https://canary.developer.fermyon.com/spin/quickstart/
, and click on Rust link again. Notice it works.
The support article currently states that users can submit issues on GitHub. We need to agree on whether we want to do that, and make sure the repo link in the article is correct.
Implement the top navigation bar design
The AssemblyScript section in wasm-languages currently references as-wasi
. We can go ahead and update these docs as per the following information.
as-wasi
as-wasi
is a third-party library that implemented WASI.
as-wasi
got superseded by import wasi
from the standard library.
as-wasi
can still be considered current and is used in a few recognisable projects.
import wasi
import wasi
from the standard library is no longer the default.
wasi-shim
Created by AssemblyScript, wasi-shim
is now what we may know as the best alternative to import wasi
(from the standard library) moving forward.
From what I can see there are a couple of spots possibly worth updating:
as-wasi
can have a secondary example using wasi-shim
).wasi-shim
, but to be fair I guess we don't have a footnote that says Rust WASI support is via wasm32-wasi
so perhaps keep it "as-is" simple on this page). Or, perhaps use the notes
section on Rust and AssemblyScript to paste wasm32-wasi
and wasi-shim
in respectively.Also we should probably do a new commit to add all the required annotations for the codeblocks across the repository (For removing copy button and formatted copy for the shell code blocks)
Originally posted by @karthik2804 in #34 (review)
Currently, if the Redis instance has a password set in redis.conf
, the Spin trigger has no way of passing that password.
ref https://redis.io/topics/security#authentication-feature
ref fermyon/spin#181
ref fermyon/spin#160
Once we release this portal, we need to freeze/remove the Spin repo docs.
I needed a reference to Spin SDKs and there is no good article in the Spin documentation to use.
We should create an article describing the Spin SDKs conceptually, which have and their support, and other SDKs we know about.
@karthik2804 has found a solution to implement search functionality, which is easy to implement.
https://docsearch.algolia.com/
We can look at implementing this soon.
Crea a PR template with a content check-list.
For existing references to *.fermyon.dev, we need to redirect to the new home in developer.fermyon.com.
Implement the landing page design
Ensure that this new domain has a top level robots.txt file and a site map.
Ensure that WebCrawler knows to index this new developer.fermyon.com
content by adding an allow all to robots.txt file.
At the same time, ensure that the top level robots.txt file from the old x.fermyon.dev domain disallows the WebCrawler.
It's probably important to include some supporting information about Spin architecture in "Using Spin" section. As an aside, I've included another issue about restructuring the sections in fermyon/spin#264
in spin/* pages, the link to other pages under spin
is currently broken. e.g.
take Spin for a spin
noticed that its broken similarly in other pages as well.
These docs are going to be out of date with the upcoming Spin core refactor. We should think about how we want to update this docs page or whether we should delete it until we have a more cohesive trigger plugin story.
We either need a Google analytics ID for this site in config/site.toml
. This could be an opportunity to try out https://plausible.io/.
Implement action workflows for tests, deployment to canary and production deployments
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.