Show a generic algorithm, like rotate from https://github.com/apple/swift/blob/main/test/Prototypes/Algorithms.swift

In the section Booleans, numbers and strings:

"In the above example, m is explicitly declared to have type Double. "

The variable "m" should be "n".

Per agreement.

They're basically un-mentioned.

The sidebar is nice for the home page, but needlessly eats space for the language tour. It would be best to have a layout that uses the full width of the page. Perhaps it would also address #9

Sidebar should contain links to:

• The language tour (GitBook)
• The language specification
• The GitHub repository of Val's compiler
• The discussions forum

I'm talking about the example here: https://tour.val-lang.dev/subscripts

Seems like 'min' should be 'max', or otherwise the the syntax of Val is completely inverted?

And of course all the results are wrong....

I had several errors after I tried
% swift build -c release
First error is
...Sources/Utils/DirectedGraph.swift:33:26: error: cannot specialize protocol type 'Collection'
public var edges: some Collection {
^

The text describing a multiline string is confusing. An example that shows how various multiline strings are manifest would be helpful. Or perhaps a link to a reference document?

Is

  let text = """
  foo
  bar
  """

different from

  let text = """
  foo
  bar
    """

etc.

signalued -> signaled.

"&" is missing in the sample code in binding lifetime section.

public fun main() {
  let weight = 1.0
  let base_length = 2.0
  var length = base_length 
  length += 3.0            
  // Q: shouldn't it be "&length += 3.0"?
  ...
}

Include a remark about how val is (semantically) doing functional updates per the state monad, efficiently.

https://github.com/dabrahams/SwiftRef shows how to do it.

Underneath the logo there's a place for these things. The theme surely is set up to acommodate them.

In this comment you mention something you need to change. If it's not already done, this issue is for that. Otherwise please close.

It might be beneficial to have a page describing Val's syntactic choices, in particular for people coming from C++.

The title says it all

The "Functions and methods" section has many examples using what seems to be a keyword "by" in arguments. I can find no place where this keyword is described, such as here preceding delta:

fun offset_let(_ v: Vector2, by delta: Vector2)

Our text columns are a bit too narrow for something that will be read on the web, and code examples are getting cut off. Unrestrained width isn't good, but where we're at is a bit too restrictive.