Adding more topics.

This commit is contained in:
Charlie 2018-05-29 15:54:37 +01:00
parent 8e140d76d6
commit 12dff0f404
48 changed files with 310 additions and 38 deletions

5
404.md Normal file
View file

@ -0,0 +1,5 @@
---
layout: default
---
Oops! Page not found.

View file

@ -1,5 +1,7 @@
# Jargonthing
This is a project that aims to demistify tech jargon for people who work with developers. Each article should be:
This is a project that aims to demistify tech jargon for people who work with developers. The target reader is therefore a non-technical individual who wishes to get a better understanding of a buzz word or topic that they have come across, either in their professional life or otherwise. It is not trying to be an authoritive source or teaching material for someone intending to seriously learn a topic
Each article should be:
- Written in simple, non-technical language.
- Self-contained.
- Consistently formatted.

View file

@ -1,6 +1,6 @@
title: Jargonthing
title: Lexicon
github: https://github.com/
collections:
topic:
output: true
permalink: /:name
permalink: /:name

View file

@ -9,7 +9,7 @@ layout: default
<div class="card border-primary">
<div class="card-body">
<h1>{{ page.title }}</h1>
{% if page.website %}
{% if page.website != "" %}
<a class="card-link" href="{{ page.website }}" target="_blank">{{ page.website }}</a>
{% endif %}
</div>

View file

@ -1,7 +1,11 @@
---
layout: topic
title: "Angular.JS"
snippet: "Angular.JS is a platform and set of tools for building large applications that run in the web browser."
website: "https://angular.io/"
---
This topic is awaiting content. Open a pull request to contribute!
Angular.JS is a [software framework](framework) that makes it easier to build complicated [client-side](client-server) applications. Originally designed to run in the [web browser](browser), it has since also been adapted to build [mobile applications](mobile-applications).
The original version of Angular.JS was released in 2010 by Google, and has since gone through many iterations and changes. It is released as [open-source software](open-source-software) and is one of the most popular frameworks of its kind.

9
_topic/assembly.markdown Normal file
View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Assembly Language"
snippet: "Assembly language is a programming language that closely represents the code that can be directly executed by a computer."
website: ""
---
Assembly language is a programming language that closely represents the code that can be directly executed by a computer.

View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Authentication"
snippet: "Authentication is the process of verifying the identity of a user."
website: ""
---
Authentication is the process of verifying the identity of a user.

View file

@ -3,4 +3,4 @@ layout: topic
title: "Authorization"
---
Authorization is the process of ensuring that a user is allowed to perform a specfic action.
Authorization is the process of ensuring that a known user is allowed to perform a specfic action. It is often preceded by the process of [Authentication](authentication).

View file

@ -1,5 +0,0 @@
---
layout: topic
title: "Web Browser"
---

8
_topic/c.markdown Normal file
View file

@ -0,0 +1,8 @@
---
layout: topic
title: "C"
snippet: "C is a programming language that is often used for communicating with hardware."
website: ""
---
C is a programming language that is often used for communicating with hardware. It is described as a 'low-level' programming language, which means that it more accurately represents what is executed by the computers processing unit, as oppose to other languages that tend to prioritise being easy for a human to understand. The result of this is that, whilst hard to use, C offers a programmer a great deal of control over how their code is executed on the computer. This has lead to its widespread use for building software that directly communicates with the hardware of a computer.

View file

@ -1,6 +1,7 @@
---
layout: topic
title: "Client-Server"
snippet: "Client-Server is a model for communication between two computer systems."
---
'Client-Server' is a model for communication between two computer systems. The role of the Server is to receive requests and act upon them, by either returning or modifying data. The role of the Client is to create and send these requests to the Server, often on behalf of a human user.

10
_topic/compiler.markdown Normal file
View file

@ -0,0 +1,10 @@
---
layout: topic
title: "Compiler"
snippet: "A compiler is a program that transforms source code into instructions that a computer can execute."
website: ""
---
A compiler is a program that transforms human readable [source code](source-code) into [binary instructions](machine-code) that a computer can execute. Most modern programming languages come with a compiler that is required in order to execute programs written in that language.
The process of transforming source code into binary instructions is often called compilation.

View file

@ -0,0 +1,8 @@
---
layout: topic
title: "Computer Program"
snippet: "A computer program is a set of instructions that a computer can understand and execute."
---
A computer program is a set of instructions that a computer can understand and execute. These instructions are usually made up of smaller, sequential steps that manipulate information stored in the computers memory in order to fulfil the desired function.

11
_topic/cplusplus.markdown Normal file
View file

@ -0,0 +1,11 @@
---
layout: topic
title: "C++"
snippet: "C++ is a programming language that is often used for building performance critical applications."
website: "https://isocpp.org/"
---
C++ is a programming language that is often used for building performance critical applications. It has seen a lot of use in games, scientific computing and important infrastructure programs like [operating systems](operating-system) and [database software](database).
C++ has a reputation as being hard to use but offers programmers a great deal of control over how the computer will execute their code. It is an extension of the the [C programming language](c).

9
_topic/csharp.markdown Normal file
View file

@ -0,0 +1,9 @@
---
layout: topic
title: "C# Programming Language"
snippet: "C# is a programming language that runs on Microsofts .NET Framework."
website: "https://docs.microsoft.com/en-us/dotnet/csharp/getting-started/introduction-to-the-csharp-language-and-the-net-framework"
---
C# is a programming language that runs on Microsofts .NET Framework.

9
_topic/database.markdown Normal file
View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Database"
snippet: "A Database is software that is responsible for storing and managing data."
website: ""
---
A Database is software that is responsible for storing and managing data.

View file

@ -2,7 +2,8 @@
layout: topic
title: ".NET Core"
website: https://dotnet.github.io/
snippet: .NET Core is a programming framework for building server side applications.
---
This topic is awaiting content. Open a pull request to contribute!
.NET Core is a programming framework for building server side applications. It is based on the original [.NET Framework](dotnet-framework) but is [open source software](open-source-software) and is designed to run on multiple [operating systems](operating-system). The primary use of .NET Core is for building fast and efficient [server-side](client-server) software and [web applications](web-application) using the [C# programming language](csharp).

View file

@ -2,9 +2,11 @@
layout: topic
title: ".NET Framework"
website: https://www.microsoft.com/net/
snippet: The .NET Framework is a software platform that makes it easier for developers to write applications for the Windows operating system.
---
The .NET Framework is a [software framework](framework) that first released by [Microsoft](microsoft) in 2001. It originally could be used to build [desktop applications](desktop-application) for the [Windows](windows) operating system but has since expanded to be used to build [server-side](client-server) [web](web-application) and [mobile](mobile-application) applications.
The .NET Framework is a [software framework](framework) that first released by [Microsoft](microsoft) in 2002. It was originally designed to build [desktop applications](desktop-application) but has since expanded to be used to build [server-side](client-server) [web](web-application) and [mobile](mobile-application) applications.
Although the .NET Framework can only run on Windows, a community project called Mono was later created to allow programs written for the .NET Framework to run on other operating systems besides Windows.
Microsft have since started a new related project called [.NET Core](dotnet-core).

View file

@ -1,4 +0,0 @@
---
layout: topic
title: "your_title"
---

View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Handelbars.JS"
snippet: "Handelbars.JS is a library for generating user interfaces for websites."
website: "http://handlebarsjs.com/"
---
Handelbars.JS is a library for generating user interfaces for websites.

9
_topic/internet.markdown Normal file
View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Internet"
snippet: "The Internet is a global network of computers that can communicate with each other."
website: ""
---
The Internet is a global network of computers that can communicate with each other. It is the largest network of its kind in the world and the primary way that people access digital information.

12
_topic/java.markdown Normal file
View file

@ -0,0 +1,12 @@
---
layout: topic
title: "Java"
snippet: "Java is a programming language and set of related tools that allows a programmer to build cross platform applications."
website: "https://www.oracle.com/java/index.html"
---
Java is a [programming language](programming-language) and set of related tools that allow a programmer to build applications that can run on multiple operating systems. It is one of the most popular programming languages in the world and has been used for building [websites](web-applications), large-scale data-processing and [mobile applications](mobile-applications).
Both industry and the [open-source](open-source-software) community frequently use Java to build critically important systems.
It has no relation to the [JavaScript](javascript) programming language.

View file

@ -3,9 +3,9 @@ layout: topic
title: "JavaScript"
---
JavaScript is a [programming language](programming-language) that was originally created to allow developers to write code that could be run in a [Web Browser](web-browser). It was first released in 1994 by the company Netscape. It has since become one of the most ubiquotous programming languages in the world and can be found executing including Web Browsers, [IoT Devices](iot-devices) and Mobile Phones.
JavaScript is a [programming language](programming-language) that was originally created to allow developers to write code that could be run in a [Web Browser](web-browser). It was first released in 1994 by the company Netscape. It has since become one of the most ubiquotous programming languages in the world and can found being used in Web Browsers, [IoT Devices](iot-devices), Mobile Phones and Deskop Applications.
It is the programming language usd in the popular [Node.JS](nodejs) [runtime](runtime).
It is the programming language used in the popular [Node.JS](nodejs) [runtime](runtime) for writing code that runs on a [web server](client-server).
It is not related to the programming language, [Java](java).

View file

@ -3,7 +3,4 @@ layout: topic
title: "Software Library"
---
A Software Library is a small collection of components that are designed to be used as part of a larger system. The components in a library usually share a single cohesive theme and do not try to dictate how they should be used by other systems.
#### Differs to
- [Software Framework](framework)
A Software Library is a small collection of components that are designed to be used as part of a larger system. The components in a library usually share a single cohesive theme and are designed to be reusable.

View file

@ -0,0 +1,8 @@
---
layout: topic
title: "Machine Code"
snippet: "Machine Code is numeric instructions that can be directly executed by a computers processing unit."
website: ""
---
Machine Code is numeric instructions that can be directly executed by a computers processing unit.

View file

@ -1,5 +1,7 @@
---
layout: topic
title: "Mobile Application"
snippet: A Mobile Application is a computer program designed to be executed on a phone.
---
A Mobile Application is a computer program designed to be executed on a phone.

View file

@ -1,6 +1,7 @@
---
layout: topic
title: "Node.JS"
snippet: Node.JS is a platform that enables developers to build and run applications written in JavaScript.
---
Node.JS is a platform that enables developers to build [server-side](client-server) applications using [JavaScript](javascript) as the programming language.

View file

@ -1,7 +1,7 @@
---
layout: topic
title: "NPM"
snippet: NPM is a tool for managing libraries and applications built for the Node.JS framework.
---
This topic is awaiting content. Open a pull request to contribute!
NPM is a tool for managing libraries and applications built for the [Node.JS](nodejs) framework.

View file

@ -0,0 +1,8 @@
---
layout: topic
title: "Objective-C"
snippet: "Objective-C is a programming language used for writing programs for Apple systems."
website: "https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html"
---
Objective-C is a programming language used for writing programs for Apple systems. It is based on the [C programming language](c) and can be used for building applications for OS-X and iOS. [Swift](swift) was created as a more modern alternative to Objective-C.

View file

@ -0,0 +1,14 @@
---
layout: topic
title: "Open Source Software"
snippet: "Open Source Software is software where the code that creates it is publicly available."
website: ""
---
Open Source Software is computer software where the original [source code](source-code) used to create that software is publicly available. This usually means that anyone can freely download, view, and edit the [source code](source-code) that is used to build a working version of the program.
## Examples
- Linux. The Linux operating system is one of the most widely used programs in the world and forms the basis of Android and Ubuntu.
- Wikipedia. All of the code and data used to create Wikipedia is freely available for anyone to obtain a copy of.

View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Operating System"
snippet: "An Operating System is software that manages how programs and hardware communicate."
website: ""
---
An Operating System is software that manages how programs and hardware communicate.

10
_topic/php.markdown Normal file
View file

@ -0,0 +1,10 @@
---
layout: topic
title: "PHP"
snippet: "PHP is a programming language used to build interactive websites."
website: "https://secure.php.net/"
---
PHP is a programming language used to build interactive websites. It allows a programmer to build a [Web Application](web-application) that can customise a users experience by programmatically modifying the responses returned to a users [Web Browser](web-browser).
PHP is often used as an introductory programming language to someone learning web development for the first time. Many of the worlds biggest websites make extensive use of PHP including [Wikipedia](https://wikipedia.org) and [Facebook](https://facebook.com).

9
_topic/r.markdown Normal file
View file

@ -0,0 +1,9 @@
---
layout: topic
title: "R"
snippet: "R is a programming language and set of tools designed for processing data and statistics."
website: "https://www.r-project.org/"
---
R is a programming language and set of tools designed for processing data and statistics.

View file

@ -1,6 +1,7 @@
---
layout: topic
title: "React.JS"
snippet: React.JS is a library for building user interfaces.
---
React.JS is a [library](/library) for building [user interfaces](ui). It utilises [JavaScript](javascript) and a special [syntax](syntax) for describing a heirachy of components that make up the interface called JSX.

9
_topic/ruby.markdown Normal file
View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Ruby"
snippet: "Ruby is a Programming Language that is known for being easy to learn and use."
website: "https://www.ruby-lang.org/en/"
---
Ruby is a Programming Language that is known for being easy to learn and use. It is often coupled with the [Ruby on Rails](ruby-on-rails) framework to build [web applications](web-applications).

View file

@ -0,0 +1,13 @@
---
layout: topic
title: "Source Code"
snippet: "Source code is the text based representation of a computer program that is easy for a human to read and write."
website: ""
---
Source code is a text based representation of a [computer program](computer-program) that is easier for a human to understand. This allows humans to be able to create and understand computer programs without having to learn the complicated [binary-based instructions](machine-code) that a computer understands.
Source code needs to go through a transformative process before a computer can understand and execute the instructions. This additional step is called [compiling](compiler).
## Examples
- [Python](python). Python is a widely used source code language that is known for its simplicity and readability.

8
_topic/sql.markdown Normal file
View file

@ -0,0 +1,8 @@
---
layout: topic
title: "SQL"
snippet: "SQL is a programming language for manipulating and retrieving data stored in a database."
website: ""
---
Structured Query Language, or SQL, is a [programming language](programming-language) for retrieving or manipulating data stored in a database. It is most often used in conjunction with an SQL Database, a type of database specifically designed to be used with the SQL language. In an SQL Database, data is stored as rows and columns in tables, similar to spreadsheets. However, SQL gives you a lot more control over what can and cannot be stored in each table, as well as allowing you to create links between tables to represent how the subjects of that data are related in the real world.

9
_topic/swift.markdown Normal file
View file

@ -0,0 +1,9 @@
---
layout: topic
title: "Swift"
snippet: "Swift is a programming language that was created by Apple to make programming for iOS easier."
website: "https://swift.org/"
---
Swift is a programming language that was created by Apple to make programming for iOS easier.

View file

@ -1,8 +1,7 @@
---
layout: topic
title: "TypeScript"
snippet: ""
snippet: "TypeScript is a programming language that makes it easier to build large programs that run in the browser."
---
This topic is awaiting content. Open a pull request to contribute!
TypeScript is a programming language that makes it easier to build large programs that run in the browser. It is based on and compatible with the [JavaScript](javascript) programming language. Like JavaScript, it can also be used to write programs for the [Node.JS](nodejs) runtime that can execute outside of the browser.

View file

@ -0,0 +1,9 @@
---
layout: topic
title: "VB.NET"
snippet: "VB.NET is a programming language created by Microsoft for the .NET platform."
website: "https://docs.microsoft.com/en-gb/dotnet/visual-basic/"
---
VB.NET is a programming language created by Microsoft for the [.NET platform](dotnet-framework). It differs from [C#](csharp) in that it often uses words instead of symbols to represent operations.

11
_topic/vuejs.markdown Normal file
View file

@ -0,0 +1,11 @@
---
layout: topic
title: "Vue.JS"
snippet: "Vue.JS is a library for building interactive user interfaces for websites."
website: "https://vuejs.org/"
---
Vue.JS is a library for building interactive user interfaces for websites. It is primarily based on [HTML](html) and [JavaScript](javascript).
## Similar to
- [React.JS](reactjs).

View file

@ -1,6 +1,7 @@
---
layout: topic
title: "Web Application"
snippte: A Web Application is a computer system that is interacted with over the World Wide Web.
---
A Web Application is a computer system that is interacted with over the [World Wide Web](world-wide-web). Users of a Web Application usually use a [Web Browser](browser) to send requests to a [Web Server](web-server) which is responsible for validating and acting on these requests.

View file

@ -0,0 +1,7 @@
---
layout: topic
title: "Web Browser"
snipper: A browser is a computer program that enables a user to access and view information stored on the World Wide Web.
---
A browser is a computer program that enables a user to access and view information stored on the [World Wide Web](world-wide-web).

View file

@ -1,5 +1,7 @@
---
layout: topic
title: "Windows"
snippet: "Window is an operating system created by Microsoft."
---
Windows is an [operating system](operating-system) created by [Microsoft](microsoft).

View file

@ -0,0 +1,9 @@
---
layout: topic
title: "World Wide Web"
snippet: "The World Wide Web is an information system that gives access to documents delivered over the Internet."
website: ""
---
The World Wide Web is an information system that gives access to documents, called web pages, delivered over the [Internet](internet).

View file

@ -17,7 +17,7 @@
}
.body-content {
min-height: 300px;
min-height: 400px;
}
.footer-github-image {
@ -31,4 +31,12 @@
hr {
margin-bottom: 0;
}
}
.jumbotron {
margin-bottom: 1rem;
}
.card-body h1 {
margin-bottom: 0;
}

View file

@ -24,7 +24,7 @@ hide_search: true
<div class='row'>
<div class='col'>
<div class='d-flex flex-row justify-content-around flex-wrap h4'>
{% for item in site.topic %}
{% for item in site.topic limit: 15 %}
<a class='badge badge-primary' href="{{ item.url }}" style='margin: 5px;'>{{ item.title }}</a>
{% endfor %}
</div>

View file

@ -1,9 +1,28 @@
echo 'Enter a unique name for the topic, lowercase, alpha-num and - only. eg: dotnet-framework'
read name
echo 'Enter a nicely formated version of yout name, eg: .NET Framework'
read nice_name
echo 'Enter a URL for the official website of the thing, eg: https://www.microsoft.com/net (optional)'
read website
echo 'Enter a short snippet description of the thing eg: .NET is a programming platform relased by Microsoft.'
read snippet
{
if [ -f ./_topic/$name.markdown ]; then
echo "File already exists. Exiting."
exit 0
fi
}
echo '---
layout: topic
title: "'$(echo $2)'"
snippet: ""
website: ""
title: "'$nice_name'"
snippet: "'$snippet'"
website: "'$website'"
---
This topic is awaiting content. Open a pull request to contribute!
' >> ./_topic/$1.markdown
'$snippet'
' >> ./_topic/$name.markdown