Glossary

Introduction

In order to make the content consistent and searchable, here are a list of words to use. See Details for more.

List

aka: an alias for X or Y

array: ordererd sequence of elements

Examples:

days = ["Monday", "Tuesday", "Wednesday"]

days = []string{"Monday", "Tuesday", "Wednesday"}

Rational:

Preferred over list because it is also a verb.
Preferred over slice because in many languages it means “cutting an array.”

References:

https://en.wikipedia.org/wiki/Array_(data_structure)

cascade: propagating X and Y info

You can configure your site to cascade front matter values to the home page and any of its descendants. - Hugo

Run cascade to update the cascade configuration from the X and Y defined in en.

dict: unordered collection of key, value pairs

Shortened form of dictionary.

Examples:

albums = { "Nirvana": "Nevermind", "AC/DC": "Back In Black" }

albums = map[string]string{ "Nirvana": "Nevermind", "AC/DC": "Back In Black" }

Rational:

Preferred over map because it is also a verb.
Preferred over hash because it is also a verb and a cryptographic operation.

References:

https://en.wikipedia.org/wiki/Associative_array

handle: receiving, processing and responding to a request

Examples:

http_handle...: for responding to an HTTP request, acting as a server.
tcp_handle...: for responding to a TCP request, acting as a server.

http: HTTP network request

Examples:

http_request...: for making an HTTP request, acting as a client.
http_handle...: for responding to an HTTP request, acting as a server.

request: make a network request

Examples:

http_request...: for making an HTTP request, acting as a client.
tcp_request...: for making a TCP request, acting as a client.

string: sequence of characters

x: a task to perform

Examples:

y: a tool or language to use

Examples:

Details

All programing languages use different words for different concept. E.g. list/array, package/module, etc.

This site aims at making examples discoverable and searchable. In that, it uses a consistent list of English words to describe similar concepts in various programing languages.

This is inherently incorrect, for example:

in Python, array is used along side list to designate the same concept. Although list is the correct term, as array is a different type.
in Go, array is slightly different from slice, even if they are confused for the same thing.

It is however possible to set “aka” values in the frontmatter of Xs and Ys.

Examples:

/en/x/array_reverse/_index.md

+++
title = "Reverse an array"
aka = ["Reverse a list"]
+++

/en/y/go/_index.md
```
+++
title = "Go"
aka = ["Golang"]
+++
```

TODO: in the event of the word being an important distinction, exceptions can be made.

aka