Merge branch 'main' into unit-testing

github · Jan 1, 2024 · 8524633 · 8524633
2 parents ded29dd + 9e6dc43
commit 8524633
Show file tree

Hide file tree

Showing 34 changed files with 207 additions and 49 deletions.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -21,7 +21,7 @@ I'm suggesting these edits to an existing topic or collection:
 
 > Please replace this line with an explanation of why you think these changes should be made.
 
-<!-- ⚠️ ... or this section ⚠️ -->
+<!-- ⚠️ this section... ⚠️ -->
 ### Curating a new topic or collection
 
 - [ ] I've formatted my changes as a new folder directory, named for the topic or collection as it appears in the URL on GitHub (e.g. `https://github.com/topics/[NAME]` or `https://github.com/collections/[NAME]`)

diff --git a/.github/workflows/jekyll_build.yml b/.github/workflows/jekyll_build.yml
@@ -36,7 +36,7 @@ jobs:
       uses: actions/[email protected]
 
     - name: ⚡️ upload artifact
-      uses: actions/upload-pages-artifact@v2
+      uses: actions/upload-pages-artifact@v3
 
   deploy:
     needs: build
@@ -49,4 +49,4 @@ jobs:
     steps:
       - name: 🚀 deploy
         id: deployment
-        uses: actions/deploy-pages@v3.0.1
+        uses: actions/deploy-pages@v4.0.2
diff --git a/README.md b/README.md
@@ -6,11 +6,11 @@ This repository houses all of the community-curated content for GitHub Topics an
 
 [Collections](https://github.com/collections) help you discover hand-picked repositories, developers, organizations, videos, and articles that share a common theme.
 
-If you want to suggest edits to an existing topic page or collection, or curate a new one, read our [contributing guide](CONTRIBUTING.md) to get started. You can also [review a list of popular topics that need more context](topics-todo.md) to get an idea of where to start.
+If you want to suggest edits to an existing Topic page or Collection, or curate a new one, read our [contributing guide](CONTRIBUTING.md) to get started. You can also [review a list of popular Topics that need more context](topics-todo.md) to get an idea of where to start.
 
 ## Running tests
 
-There are some lint tests in place to ensure each topic is formatted in the way we expect. GitHub
+There are some lint tests in place to ensure each Topic is formatted in the way we expect. GitHub
 Actions will run the tests automatically. If you want to run the tests yourself locally, you will
 need Ruby and Bundler installed.
 

diff --git a/collections/made-in-france/index.md b/collections/made-in-france/index.md
@@ -18,6 +18,7 @@ items:
  - mui/material-ui
  - PrestaShop/PrestaShop
  - rlibre/x4js
+ - StanGirard/quivr
 display_name: Made in France
 created_by: ferdi05
 image: made-in-france.png

diff --git a/collections/static-site-generators/index.md b/collections/static-site-generators/index.md
@@ -26,6 +26,7 @@ items:
  - getzola/zola
  - lumeland/lume
  - docsifyjs/docsify
+ - shuding/nextra
 display_name: Static Site Generators
 created_by: jakejarvis
 ---

diff --git a/topics-todo.md b/topics-todo.md
@@ -4,91 +4,91 @@ This is a list of the most-used topics on GitHub that don't yet have a curated t
 
 Information included in this repository will appear on each topic's respective page, helping others on GitHub better understand the topic and, by extension, what repositories tagged with that topic are about.
 
+- [x] [ai](https://github.com/topics/ai/)
+- [x] [ajax](https://github.com/topics/ajax/)
 - [x] [android-library](https://github.com/topics/android-library/)
 - [x] [angular-cli](https://github.com/topics/angular-cli/)
 - [x] [animation](https://github.com/topics/animation/)
 - [x] [ansible-role](https://github.com/topics/ansible-role/)
 - [x] [app](https://github.com/topics/app/)
 - [x] [argo-floats](https://github.com/topics/argo-floats/)
+- [x] [artificial-intelligence](https://github.com/topics/artificial-intelligence/)
 - [x] [authentication](https://github.com/topics/authentication/)
 - [x] [automation](https://github.com/topics/automation/)
+- [x] [bioinformatics](https://github.com/topics/bioinformatics/)
+- [x] [blockchain](https://github.com/topics/blockchain/)
 - [x] [boilerplate](https://github.com/topics/boilerplate/)
 - [x] [canvas](https://github.com/topics/canvas/)
 - [x] [chatbot](https://github.com/topics/chatbot/)
+- [x] [chrome](https://github.com/topics/chrome/)
 - [x] [client](https://github.com/topics/client/)
 - [x] [command-line](https://github.com/topics/command-line/)
+- [x] [compiler](https://github.com/topics/compiler/)
+- [x] [composer](https://github.com/topics/composer/)
+- [x] [computer-vision](https://github.com/topics/computer-vision/)
 - [x] [configuration](https://github.com/topics/configuration/)
 - [x] [crawler](https://github.com/topics/crawler/)
 - [x] [cryptography](https://github.com/topics/cryptography/)
 - [x] [data-analysis](https://github.com/topics/data-analysis/)
 - [x] [data-science](https://github.com/topics/data-science/)
 - [x] [data](https://github.com/topics/data/)
-- [ ] [demo](https://github.com/topics/demo/)
+- [x] [demo](https://github.com/topics/demo/)
 - [x] [devops](https://github.com/topics/devops/)
+- [x] [discord](https://github.com/topics/discord/)
 - [x] [docker-compose](https://github.com/topics/docker-compose/)
 - [x] [docker-image](https://github.com/topics/docker-image/)
 - [x] [dockerfile](https://github.com/topics/dockerfile/)
+- [x] [dot-net](https://github.com/topics/dot-net/)
 - [x] [education](https://github.com/topics/education/)
 - [x] [elasticsearch](https://github.com/topics/elasticsearch/)
-- [ ] [example](https://github.com/topics/example/)
+- [x] [ethereum](https://github.com/topics/ethereum/)
+- [x] [example](https://github.com/topics/example/)
 - [x] [functional-programming](https://github.com/topics/functional-programming/)
 - [x] [game-development](https://github.com/topics/game-development/)
 - [ ] [generator](https://github.com/topics/generator/)
 - [x] [gui](https://github.com/topics/gui/)
+- [x] [image-processing](https://github.com/topics/image-processing/)
 - [ ] [image](https://github.com/topics/image/)
 - [x] [iot](https://github.com/topics/iot/)
+- [x] [javafx](https://github.com/topics/javafx/)
 - [x] [keras](https://github.com/topics/keras/)
 - [ ] [logging](https://github.com/topics/logging/)
+- [x] [lua](https://github.com/topics/lua/)
+- [x] [maven](https://github.com/topics/maven/)
 - [x] [microservice](https://github.com/topics/microservice/)
+- [x] [monitoring](https://github.com/topics/monitoring/)
 - [x] [mvc](https://github.com/topics/mvc/)
 - [ ] [network](https://github.com/topics/network/)
+- [x] [neural-network](https://github.com/topics/neural-network/)
+- [x] [objective-c](https://github.com/topics/objective-c/)
+- [x] [opencv](https://github.com/topics/opencv/)
+- [x] [opengl](https://github.com/topics/opengl/)
 - [ ] [parser](https://github.com/topics/parser/)
 - [x] [personal-website](https://github.com/topics/personal-website/)
 - [x] [portfolio](https://github.com/topics/portfolio/)
 - [ ] [project](https://github.com/topics/project/)
 - [x] [react-router](https://github.com/topics/react-router/)
-- [ ] [script](https://github.com/topics/script/)
+- [x] [robotics](https://github.com/topics/robotics/)
+- [x] [script](https://github.com/topics/script/)
 - [x] [sdk](https://github.com/topics/sdk/)
 - [ ] [simulation](https://github.com/topics/simulation/)
 - [x] [socket-io](https://github.com/topics/socket-io/)
 - [x] [spark](https://github.com/topics/spark/)
 - [ ] [spring-mvc](https://github.com/topics/spring-mvc/)
 - [x] [spring](https://github.com/topics/spring/)
+- [x] [sql](https://github.com/topics/sql/)
 - [x] [statistics](https://github.com/topics/statistics/)
 - [x] [telegram-bot](https://github.com/topics/telegram-bot/)
+- [x] [terminal](https://github.com/topics/terminal/)
 - [x] [test](https://github.com/topics/test/)
 - [ ] [tool](https://github.com/topics/tool/)
 - [x] [tutorial](https://github.com/topics/tutorial/)
 - [x] [ui](https://github.com/topics/ui/)
 - [x] [utility](https://github.com/topics/utility/)
 - [x] [video](https://github.com/topics/video/)
 - [x] [web](https://github.com/topics/web/)
-- [x] [website](https://github.com/topics/website/)
-- [x] [ai](https://github.com/topics/ai/)
-- [x] [ajax](https://github.com/topics/ajax/)
-- [x] [artificial-intelligence](https://github.com/topics/artificial-intelligence/)
-- [x] [bioinformatics](https://github.com/topics/bioinformatics/)
-- [x] [blockchain](https://github.com/topics/blockchain/)
-- [x] [chrome](https://github.com/topics/chrome/)
-- [x] [compiler](https://github.com/topics/compiler/)
-- [x] [composer](https://github.com/topics/composer/)
-- [x] [computer-vision](https://github.com/topics/computer-vision/)
-- [x] [discord](https://github.com/topics/discord/)
-- [x] [dot-net](https://github.com/topics/dot-net/)
-- [x] [ethereum](https://github.com/topics/ethereum/)
-- [x] [image-processing](https://github.com/topics/image-processing/)
-- [x] [javafx](https://github.com/topics/javafx/)
-- [x] [lua](https://github.com/topics/lua/)
-- [x] [maven](https://github.com/topics/maven/)
-- [x] [monitoring](https://github.com/topics/monitoring/)
-- [x] [neural-network](https://github.com/topics/neural-network/)
-- [x] [objective-c](https://github.com/topics/objective-c/)
-- [x] [opencv](https://github.com/topics/opencv/)
-- [x] [opengl](https://github.com/topics/opengl/)
-- [x] [robotics](https://github.com/topics/robotics/)
-- [x] [sql](https://github.com/topics/sql/)
-- [x] [terminal](https://github.com/topics/terminal/)
 - [x] [webapp](https://github.com/topics/webapp/)
+- [x] [website](https://github.com/topics/website/)
 - [x] [winforms](https://github.com/topics/winforms/)
 - [x] [wpf](https://github.com/topics/wpf/)
-- [x] [xml](https://github.com/topics/xml/)
+- [x] [xml](https://github.com/topics/xml/)
diff --git a/topics/algorithm/index.md b/topics/algorithm/index.md
@@ -6,4 +6,4 @@ short_description: Algorithms are self-contained sequences that carry out a vari
 topic: algorithm
 wikipedia_url: https://en.wikipedia.org/wiki/Algorithm
 ---
-Algorithms are detailed sets of guidelines created for a computer program to complete tasks efficiently and thoroughly.
+Algorithms are detailed sets of guidelines created for a computer program to complete tasks efficiently and thoroughly. Algorithms in computer programming are employed to solve complex problems. Various cutting-edge technologies including artificial intelligence (AI) and machine learning (ML), operate based on simple or complex algorithms.
diff --git a/topics/async-await/index.md b/topics/async-await/index.md
@@ -0,0 +1,9 @@
+---
+topic: async-await
+display_name: async/await
+short_description: async/await allows an asynchronous, non-blocking function to be structured in a way similar to an ordinary synchronous function.
+related: callback, coroutines, async, promise, future, actor-model, continuation-passing-style, concurrent-computing
+released: 2007
+wikipedia_url: https://en.wikipedia.org/wiki/Async/await
+---
+In computer programming, the **async/await** pattern is a syntactic feature of many programming languages that allows an asynchronous, non-blocking function to be structured in a way similar to an ordinary synchronous function, and is primarily intended to provide opportunities for the program to execute other code while waiting for a long-running, asynchronous task to complete, usually represented by promises or similar data structures.
diff --git a/topics/capnproto/index.md b/topics/capnproto/index.md
@@ -4,11 +4,11 @@ created_by: Kenton Varda
 display_name: Cap'n Proto
 github_url: https://github.com/capnproto/
 logo: capnproto.png
-related: serialization, rpc, capabilities
+related: serialization, rpc, capabilities, grpc, json, protobuf
 released: 2013
 short_description: Cap’n Proto is a data interchange format and capability-based RPC system.
 topic: capnproto
 url: https://capnproto.org/
 wikipedia_url: https://en.wikipedia.org/wiki/Cap%27n_Proto
 ---
-Cap’n Proto is an insanely fast data interchange format and capability-based RPC system. Think JSON, except binary. Or think Protocol Buffers, except faster.
+**Cap’n Proto** is an insanely fast data interchange format and capability-based RPC system. Think JSON, except binary. Or think Protocol Buffers, except faster.
diff --git a/topics/css-framework/index.md b/topics/css-framework/index.md
@@ -13,3 +13,6 @@ wikipedia_url: https://en.wikipedia.org/wiki/CSS_framework
 * [Responsiveness](https://github.com/topics/responsive) (often times including breakpoints and [viewport](https://github.com/topics/viewport))
 
 They often have their own class notation and many use [preprocessors](https://github.com/topics/css-preprocessor) like [Sass](https://github.com/topics/sass), [Less](https://github.com/topics/less) or [Stylus](https://github.com/topics/stylus).
+
+Related Collections:
+  - [CSS frameworks](https://github.com/collections/css-frameworks)
diff --git a/topics/demo/index.md b/topics/demo/index.md
@@ -0,0 +1,8 @@
+---
+aliases: demos
+display_name: Demo
+short_description: A example of a product or system.
+topic: demo
+wikipedia_url: https://en.wikipedia.org/wiki/Technology_demonstration
+---
+A rough example or otherwise incomplete version of a conceivable product or future system.
diff --git a/topics/docker/index.md b/topics/docker/index.md
@@ -9,5 +9,6 @@ short_description: Docker is a platform built for developers to build and run ap
 topic: docker
 url: https://www.docker.com
 wikipedia_url: https://en.wikipedia.org/wiki/Docker_(software)
+related: container-image, containerization, docker-compose
 ---
-Docker is software that provides containers, which allows teams to emulate development environments. Docker began as an internal project, initially developed by dotCloud engineers.
+**Docker** is software that provides containers, which allows teams to emulate development environments. It began as an internal project, initially developed by dotCloud engineers.
diff --git a/topics/example/index.md b/topics/example/index.md
@@ -0,0 +1,7 @@
+---
+aliases: examples
+display_name: Example
+short_description: A representation of something.
+topic: example
+---
+A particular instance of something that is a representative of a group, or an illustration of somethign that's been generally described.
diff --git a/topics/graphql/index.md b/topics/graphql/index.md
@@ -5,10 +5,10 @@ display_name: GraphQL
 github_url: https://github.com/graphql
 logo: graphql.png
 released: 2015
-related: api, rest
+related: api, rest, graphiql, sparql, sql
 short_description: GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data.
 topic: graphql
 url: http://graphql.org/
 wikipedia_url: https://en.wikipedia.org/wiki/GraphQL
 ---
-GraphQL is a data query language developed by Facebook. It provides an alternative to REST and ad-hoc webservice architectures. It allows clients to define the structure of the data required, and exactly the same structure of the data is returned from the server. It is a strongly typed runtime which allows clients to dictate what data is needed.
+**GraphQL** is a data query language developed by Facebook. It provides an alternative to REST and ad-hoc webservice architectures. It allows clients to define the structure of the data required, and exactly the same structure of the data is returned from the server. It is a strongly typed runtime which allows clients to dictate what data is needed.
diff --git a/topics/grpc/index.md b/topics/grpc/index.md
@@ -8,5 +8,6 @@ short_description: gRPC is a high performance RPC framework.
 topic: grpc
 url: https://grpc.io/
 wikipedia_url: https://en.wikipedia.org/wiki/GRPC
+related: rpc, http2, protobuf, capn-proto, json-rpc
 ---
-gRPC is a modern open source high performance RPC framework that can run in any environment. It can efficiently connect services in and across data centers with pluggable support for load balancing, tracing, health checking and authentication. It is also applicable in last mile of distributed computing to connect devices, mobile applications and browsers to backend services.
+**gRPC** (**gRPC Remote Procedure Calls**) is a modern open source high performance RPC framework that can run in any environment. It can efficiently connect services in and across data centers with pluggable support for load balancing, tracing, health checking and authentication. It is also applicable in last mile of distributed computing to connect devices, mobile applications and browsers to backend services.
diff --git a/topics/julia-sets/index.md b/topics/julia-sets/index.md
@@ -0,0 +1,13 @@
+---
+aliases: julia-fractal, julia-set
+display_name: Julia Sets
+short_description: Julia Sets are mathematical objects generally associated with fractals.
+topic: julia-sets
+logo: julia-sets.png
+wikipedia_url: https://en.wikipedia.org/wiki/Julia_set
+related: mandelbrot, fractal
+---
+Julia Sets are mathematical objects relating to the field of complex dynamics. In general, Julia sets are studied in parallel to Fatou sets, as they are complementary sets defined from a complex function.
+To be specific, in a metric space $(X,d)$, a Fatou set of a map $f: X \to X$ is the maximal open subset of $X$ on which the family of iterates $\lbrace f^n \rbrace$ is equicontinuous, and the Julia set is its complement in $X$.
+
+To approximate images of these sets, a common approach is to iterate the function of interest over some subset of the complex plane, which often yield beautiful fractals.
diff --git a/topics/julia-sets/julia-sets.png b/topics/julia-sets/julia-sets.png
diff --git a/topics/openapi/index.md b/topics/openapi/index.md
@@ -0,0 +1,14 @@
+---
+topic: openapi
+aliases: open-api, swagger-spec, swagger-specification, openapi-spec, openapi-specification, open-api-specification, oas, openapi-description
+display_name: OpenAPI Specification
+short_description: The OpenAPI Specification is a specification for describing, producing, consuming, and visualizing web services.
+related: json-schema, raml, rest-api
+created_by: OpenAPI Initiative, Tony Tam, Darrel Miller, Mike Ralphson, Ron Ratovsky, Uri Sarid, Jason Harmon
+released: August 10, 2011
+url: https://www.openapis.org/
+wikipedia_url: https://en.wikipedia.org/wiki/OpenAPI_Specification
+github_url: https://github.com/OAI/OpenAPI-Specification
+---
+The **OpenAPI Specification** (**OAS**), previously known as the **Swagger Specification**, is a specification for a programming language-agnostic, machine-readable interface definition language for describing, producing, consuming, and visualizing web services. OpenAPI documents describe API services and are represented in YAML or JSON formats.
+
diff --git a/topics/post-quantum-cryptography/index.md b/topics/post-quantum-cryptography/index.md
@@ -0,0 +1,9 @@
+---
+display_name: Post-quantum cryptography
+topic: post-quantum-cryptography
+aliases: pqc, pqcrypto, postquantum, post-quantum, quantum-safe-cryptography
+related: cryptography, lattice-based-crypto, hash-based-signatures, kyber, falcon, dilithium
+short_description: Cryptography resistant to quantum computers.
+wikipedia_url: https://en.wikipedia.org/wiki/Post-quantum_cryptography
+---
+Cryptographic algorithms secure against potential future quantum computers.
diff --git a/topics/promise/index.md b/topics/promise/index.md
@@ -0,0 +1,10 @@
+---
+topic: promise
+display_name: Promise
+short_description: A promise is an object returned by an asynchronous function, which represents the current state of the operation.
+related: future, async-await, callback, deferred, coroutines, fiber, concurrency
+wikipedia_url: https://en.wikipedia.org/wiki/Futures_and_promises
+created_by: Barbara Liskov, Liuba Shrira, Mark S. Miller, Dean Tribble, Rob Jellinghaus, Daniel P. Friedman
+released: 1988
+---
+A **promise** is an object returned by an asynchronous function, which represents the current state of the operation. At the time the promise is returned to the caller, the operation often isn't finished, but the promise object provides methods to handle the eventual success or failure of the operation.
diff --git a/topics/query/index.md b/topics/query/index.md
@@ -0,0 +1,9 @@
+---
+topic: query
+display_name: Query (disambiguation)
+short_description: The term query can either mean query-string or sql-query.
+related: query-string, sql-query
+---
+The term "**query**" can mean multiple things:
+* [query-string](/topics/query-string) as part of an [URL](/topics/url)
+* [sql-query](/topics/sql-query) to query a [database](/topics/database)
diff --git a/topics/rdf/index.md b/topics/rdf/index.md
@@ -0,0 +1,10 @@
+---
+topic: rdf
+display_name: RDF (Resource Description Framework)
+short_description: RDF is used for data interchange, using URIs to name the relations between things and a directed labeled graph for representation.
+related: semantic-web, sparql, web-ontology-language, shacl, json-ld, n-triples, rql, versa, shex
+created_by: W3C, IBM, Microsoft, Netscape, Nokia, Reuters, SoftQuad, University of Michigan
+released: October 1997
+wikipedia_url: https://en.wikipedia.org/wiki/Resource_Description_Framework
+---
+**RDF** (**Resource Description Framework**) is a standard model for data interchange on the web, using URIs to name the relationships between things and a directed, labeled graph to represent the data.