diff options
Diffstat (limited to 'src')
| -rw-r--r-- | src/SPO notes.md | 587 | ||||
| -rw-r--r-- | src/_footer.html | 2 | ||||
| -rw-r--r-- | src/_header.html | 10 | ||||
| -rw-r--r-- | src/ase.md | 754 | ||||
| -rw-r--r-- | src/game.md | 22 | ||||
| -rw-r--r-- | src/index.md | 14 | ||||
| -rw-r--r-- | src/styles/style.css | 91 |
7 files changed, 1480 insertions, 0 deletions
diff --git a/src/SPO notes.md b/src/SPO notes.md new file mode 100644 index 0000000..06d676e --- /dev/null +++ b/src/SPO notes.md @@ -0,0 +1,587 @@ +# Exam + +- 15 minute video presentation +- 1 hour to record +- Chosen subject appears on digital exam + + + + + +# Language processors + +Most important problem in computing : increasing programmer productivity +to improve speed of software release. + +This can be improved with: + +- Software process (eg: AGIL) about 20% increase +- Good tools 10% +- Better programming language design immense increase + +Example: + Quicksort is twice as much code in C than Haskell + +This can be more readable + +You can gain deeper understanding of programming through learning about compilers. + +## Programming languages + +- Set of rules to tell a computer what operations to perform +- For communicating an algorithm +- Linguistic framework +- Symbols, words, rules of grammar, rules of semantics + +### Why are there so many programming languages? + +Programming has evolved over time because different programming languages can be desinged for different types of programs. + +### Types of programming languages + +- Low level - high level 1st-2nd gen +- Paradigms + - Imperative / object oriented 3rd gen + - Logic / declarative (database languages) 4th gen + - Functional / logical 5th gen + - Reactive programming possible 6th gen? + +We are in the "multi-paradigm era", Anders Hejlsberg says languages in of the future will be a mix of all existing paradigms. + +### What is a good language? + +- Formerly: run-time performance +- Now: Lifecycle (ease of designing, coding, debugging, maintainance, reusability) +- Fads + +Programming language characterstics can be broken down into readibility, writability and reliability. + +Static / dynamic typed languages end up with the same amount of time spent debugging. The only difference is where that time is spent. + +Programming languages are languages with no ambiguitity and vagueness. Everything is exact. A sentence means one thing or it means nothing. + +Programming languages require specification. Example: C# docs. Syntax needs to be specified, scope rules, type rules, semantics (or runtime semantics). + +Types of specification: +- Formal: Precise, mathematical +- Informal: description in English +- Usually both + +Language specification consists of: +- Syntax, usually formal +- Contextual constraits + - Scope rules (English / formal) + - Type rules + - Semantics + +### Does syntax matter? + +Syntax is the visible part of the language. The paradigm is the next most visible. Most invisible part is the language semantics. But clear semantics usually means simple and efficient implementations. + +Yes. Syntax matters. + +## Language Processors + +- Text Editors / IDEs +- Translators + - Compiler, assembler, disassembler, etc +- Interpreters + +### Interpreters + +Take source code and input and produces output. For example, web browser. + +### Compilation + +A 2-step process. Source program is inputted to compiler and a new program target program is outputted from the compiler. However this is much more complicated. Lexical-, syntax-, semantic analysis, code generation (IL)?. Sometimes you may generate high-level code. For example, taking source and converting it to C code. + +Phases: +- Syntax analysis -> Error reports | AST +- Contextual analysis -> Error reports | DAST +- Code generation (Semantics) -> Object code + +Symbol tables can be accessed from several phases. + +### Compiler design + +Compiler design is strong affected and strong affects programming language design. Advantages of good compiler: easier to learn, read, understand. Fewer bugs. More reliable. More diagnostic messages and tools. + +There are tools to help write compilers (compiler generators/ compiler compiler) + +- Scanner generators + - JLex +- Parser generators + - JavaCUP, Yacc +- Front-end generator + - SableCC, JavaCC, ANTLR +- Code-generation tools + + + + +# Programming language evolution and tombstone diagrams + +Most new languages are invented out of frustration. When a new language is created it tends to be because it would be an improvement over some existing language. For example, Fortran was invented to improve programmer productivity. + +## Programming language design + +1. Create ideas + - Do a problem analysis (what is the purpose?, who is this for?) + - Take inspiration from existing languages + - Create some example programs +2. Describe/define (SS) +3. Implement (SPO) +4. Evaluate +5. Repeat until satisfied + +The programming language critera table can be used to generate ideas for or evaluate a language's design. Reusability and relocatability of code has become a more and more important criteria over time. + +## Programming language history + +40-50s: Assembly languages made programming more readable more usable. Came with a compiler that could translate assembly to machine operations. + +50s: Fortran was invented, first high-level language. Now programs could be developed machine independant. + +60s: Programming paradigms started taking over. Structured programming. Pascale: No GOTO, Types. OOP. + +70s: C invented for high-level programming with low-level power. Ada invented as a means to avoid using hundreds of different programming languages. Functional programming starts off. + +80s: OOP really takes over. C++ invented (thought of as C with classes). More discussion about functional programming. + +00s: Distributed systems. C# + .Net CLR (common language runtime system). + +10s: Multi-paradigm (OO + FP) + +## Tombstone diagrams - gravstens diagramer + +A notation consisting of puzzle pieces that can be used to reason about language processors and programs. + +- Program P implemented in language L (tombstone) +- Translator implemented in language L (square tombstone) +- Machine implemented in hardware M (shield) +- Language interpreter in L (square box) + +These can be combined to give a general diagram of some source to target language scenario. + +* Cross compilation: a compiler that runs on one machine, that emits code for another machine. +* Two-stage compilation: a composition of two translators. Output of first translator is provided as input to the second. Mainly IL but can be any language. +* Interpreters: provide better platform indepedence. Useful for testing and debugging. Typically slower than compilers. + +Bootstrapping can be used as a way to generate more efficient compilers. + + + + +# The ac language and compiler + +## Phases of a compiler + +Phases: +- Syntax analysis -> Error reports | AST +- Contextual analysis -> Error reports | DAST +- Code generation (Semantics) -> Object code + +The phases can be seen as the transformation steps for transforming some source code into object code. + +- Syntax analysis <-> Syntax + - Lexical analysis <-> Regular Expressions + - Parsing <-> CFG +- Contextual analysis <-> Contextual constraints + - Scope checking <-> Scope rules (static semantics) + - Type checking <-> Type rules (static semantics) +- Code generation <-> Semantics (dynamic semantics) + +Modern compilers all make use of symbol tables. This can generally be used in any phase of compilation but it is now best practice to only access it from type checker / contextual analysis. + +## Phases of a simple compiler + +- Syntax analysis + - Scanner/Lexer -> tokens + - Parser: tokens -> AST +- Contextual analysis + - Symbol table: AST -> symbol table + - Semantic analysis -> DAST +- Code generation + - Translation + +Scanner/Lexer phase takes input source code and produces a stream of tokens. Tokens have and type and value. + +Parsing phase is used to determine if the stream of tokens conforms to the languages grammar specification. This phase either produces an AST or returns errors. + +Contextual analysis for checking the semantics. A symbol table is used to process declarations and to check for type consistency. + +Symbol table is generally just a key-value list. + +Type checking: check each node and ensure child nodes are consistent with their types. For example adding an int to a float. The compiler must specificy what to do in this case. + +Code generation: formulation of target-machine instructions that represent the semantics of the source program. + +## The ac language (adding calculator) + +A simple language for arithmetic. Monolithic scope, meaning a variable can only be declared once. Target of translation: dc (desk calculator) + +Example ac program: + + f b // float b + i a // int a + a = 5 + b = a + 3.2 + p b // print b + +### Formal definition of ac + +- Syntax specification + - Context free grammar (CFG) +- Token specification + - Regular expressions (RE) + +## Context free grammar (CFG) + +A set of production rules for a language. Two types of symbols: terminals and non-terminals. Terminals cannot be rewritten (id, num, etc). Non-terminals are rules like (prog, scope, etc). + +A syntax tree / parse tree can be used to show the production rules of some source code in a tree structure. + +## Regular expressions (RE) + +For specifying tokens. For example: id, num, "+", "-", etc. + + + + +# Language specifications + +A communication device between people who need a common understanding of the programming language or PL. For example, the language desinger, implementor, user, etc. + +What should be specified? Syntax, contextual constraints or static semantics (scope/type rules), semantics (runtime semantics). + +How is a language specified? +- Formal: Precise, mathematical +- Informal: description in English +- Usually both + +A language specification needs to address: +- Syntax + - Token grammar: Regular expressions + - Context free grammar: BNF EBNF +- Contextual constraints + - Scope rules (static semantics) + - Often informal + - Type rules (static semantics) + - Informal or formal +- Semantics (dynamic semantics) + - Informal or formal + +## Syntax terminology + +* Sentence: string of characters over some alphabet +* Language: set of sentences +* Lexeme: lowest level syntatic unit of a language +* Token: a category of lexemes (e.g. identifier) + +## Formal definition of languages + +* Generators: a device that generates senteces of a language. +* Recognizer: reads input strings over the alphabet and decides whether the input strings belong to the language. + +## Syntax specification + +Syntax is specified suing a CFG. + - a finite set of terminals (tokens) + - a finite set of non-terminals + - a start symbol + - a finite set of production rules + +Usually CFG are written in BNF notation. Example: + + N ::= a + N ::= a | B | ... + +Note: non-terminals are often enclosed with angle brackets. Example: + + <N> ::= a | <B> | ... + <B> ::= ... + +In BNF, syntactic lists are described using recursion. + +## Derivations + +This is where you take some source code and you step through the CFG with it to see which rules are rewritten to deeper rules, until you get the end result. This can also be represented as a parse tree. + +Leftmost derivation (from left to right) and rightmost derivation (from right to left). + +Leftmost derivation always choses the leftmost possible non-terminal and vice-versa for rightmost derivation. + +## Ambiguity in grammars + +A grammar is ambiguous if a string (sentence) can be defined by more than one different parse trees. Ususally ambiguity is undesirable and CFGs are rewritten to disallow this behaviour. This rewritting process can be done systematically. + +A 'dangling-else' problem can be a sign of ambiguity in a language. + +* Sometimes obvious, sometimes difficult to spot. +* Ambiguity in grammars is an undecidable property. + +## EBNF + +A non-standardised extension to BNF notation. + +* Optional parts are placed in brackets [] (sometimes question mark) +* Alternatives can be expressed in-line using parentheses () +* Reptitions (0 or more) are placed inside curly braces {} (sometimes parentheses asterisk ()* ) + +EBNF can also be rewritten to standard BNF fairly easily. + + + +# Context free grammars + +## Properties of grammars (non-terminals) + +* Left-recursive: `N ::= N ...` +* Right-recursive: `N ::= ... N` +* Nullable: `expression ::= λ` +* Useless: if a non-terminal can never produce a string of terminal symbols. + +## Grammar transformations + +* Left factorization: `X Y | X Z` is transformed to `X (Y | Z)` +* Elimination of left-recursion: `N ::= X | N Y` becomes `N ::= X Y*` +* Substitution of non-terminals: for clearer CFGs + +## From tokens to parse tree + +Parsing is finding the structure in a stream of tokens. This is done by the parser. + +Two well known ways to parse: +- top-down (Leftmost derivation / LL), constructed in pre-order. +- bottom-up (Rightmost derivation in reverse / LR), constructed in post-order. + +## First sets + +The set of all terminal symbols, in order, derived from a sentence S. The empty string λ is never included. + +## Follow sets + +The set of terminals that can follow a non-terminal A, where the EOF symbol is $. + +## LL(1) grammars + +- Cannot be left-recursive. +- Cannot contain ambiguity. +- Some languages have no LL(1) grammar. +- λ-free grammars are very easy as you only need to check for the first set. + +## LR grammars + +- Can be parsed using an LR algorithm. +- Harder to implement parsers for LR than LL. +- Can recognize a bigger class of grammars than LL. +- LR parsing methods are the most commonly used for automatic tools today. + + + + +# Lexical analysis + +## Developing a scanner + +The scanner/lexer is what reads through source code character by character and divides them into lexemes and tokens. This includes whitespace which can have meaning for languages like Python. + +A Java implementation of a scanner will normally return instances of a Token class, containing a 'kind' and 'spelling'. Some tokens, like floats, ints, etc, have one single spelling so in some cases spelling can be left blank. + +How do we know how to implement a scanner? Read the language specification. Included in the specification is typically tokens/lexemes as regular expressions and reserved words. + +### Lexical elements + +- Character set (ASCII vs Unicode) +- Identifiers +- Operators +- Keywords +- Elementary data +- Noise words +- Blank space +- Layout +- Comments +- Delimiters + +Lexem structure can be more detailed for example allowing escaping characters in strings or allowing a null string. Another example would be 0.1 vs 00.1 or .1, 10. vs 1..10 and so on. + +The audience of your PL matters for lexical design, for example if target audience are C programmers they will prefer curly braces over begin-end keywords. It is a good idea to keep your design simple though. + +### Regular grammars/expressions + +It is generally better to use regular expressions instead of production rules where possible. Regular expressions are typically easy to implement. REs can be implemented by finite state machines (FSM). These automatas can then be easily implemented in code and as such make the job of implementing a scanner/lexer a little easier. + +### Implement a scanner based on RE by hand + +1. Express the 'lexical' grammar as RE. Sometimes it is easier to start with (E)BNF and do the necessary transformations. +2. For each variant use a switch on the first character by peeking the input stream. +3. For each repetition (..)* use a while loop that keeps going as look as the peeking input yields an expected character. +4. If there are multiple REs then use a switch to determine which rule is being recognized before following steps 2-3. + +* Hand-made scanners are easy for simple token arguments but can be hard and error prone for more complicated grammars. +* The task can be automated. +* Most compilers are developed using a generated scanner. + +## Generating scanners + +Something about REs and the different types of FAs are equivalent. +There is an algorithm for transforming NDFA with epsilon into DFAs. DFAs are easily implementable by computers. + +A scanner generator a program that takes tokens as REs and will generate a scanner based on a FAs in whatever language. JLex/Lex/CSharpLex are tools for generating a scanner that recognizes tokens. + +## Performance considerations + +Performance of scanners is important for production compilers. Size of scanner sometimes matters. Note: modern scanners use explicit control, not table, because bigger tables may perform worse on modern architectures. + + + +# Top down parsing + +The job of the syntax analysis, is to read to source text and determine it's phase structure. +This can be used to construct the AST. The input to the scanner is the stream of characters which output a stream of tokens to the parser or reports errors. The parser produces the AST or reports errors again. + +Top down parsing example of "Micro English". This is always done with left derivation. + + Sentence Verb Object . + The Noun Verb Object . + The cat Verb Object . + The cat sees a Object . + The cat sees a Noun . + The cat sees a rat + +This is equivalent to the parse tree that would be produced from the sentence. So Top down is a straight-forward parsing algorithm. The parse structure corresponds to the set of procedures. + +## Recursive decent parsing + +Each non-terminal will have a parse method. There will also need to be a method that asks for the next token. This function will either return the this token or give an error in the event of an unexepected token. + + private void parseSentence() { + parseSubject(); + parseVerb(); + parseObject(); + accept('.'); + } + +This is a little more involved when there are alternatives. This can be implemented using if-elseif or a switch structure that checks for the alternatives. + +## Algo to convert EBNF into a RD parser + +Foreach non-terminal in the grammar, create a parse method. Parsing a terminal just uses the 'accept' method. Parsing of non-terminals is just method calls to those non-terminal's parse methods in order. If there are repetitions, (0 .. more) you use a while loop. As long as the current token is in the first set, you keep parsing it. Use a switch case of if-else for alternatives. + +For systematic development of a RD parser: 17:36 in video 7. This process is so mechanical that there are tools for doing this. These are known as parser generators. One tool JavaCC is based on LL(k) grammars so you can specify how many symbols it should look at at once. This allows for fine control when parsing. + +If we want the parser to return an AST each of the parse methods should return their little bit of the AST instead of void. (Think of our visitor methods). + +## The visitor pattern (briefly) + +For OOP the visitor pattern enbales the definition of a new operator on an object structure without changing classes of the objects. + +## LL(1) grammars + +A grammar which can be parsed with a top-down parse with a lookahead (in the input stream of tokens) of one token. + +Lecture 7 @ 32:00 for formal definition of LL(1) grammar. + +### Table-driven LL(1) parsers + +A table is generated that simulates the way the regular parser's stack works. This presumably doesn't consume as much memory as a traditional parser's stack. The table is constructed with non-terminals and the lookahead terminals. The table tells which rule to use in the grammar. 49:00 Lecture 7. ANTLR an example of a Java parser generator, that allows LL(*) grammars and is table-driven. + + + + +# Bottom up parsing + +LR languages are more powerful than LL. +- LR(0), SLR(1), LALR(1), LR(k) grammars. +- Can handle left recursion. +- Usually more convenient because less need to rewrite gramamr. +- Most commonly used for parsing methods in automatic tools today. + +- LR(0): The simplest algorithm. +- SLR(1): An improved LR(0). +- LR(1): LR(0) with extra lookahead token. +- LR(k): for k>0 tokens +- LALR: "watered down" version of LR(1) + +Read through every construction and recognize it at the end. 13:00 Lecture 8. + +There are tools that can automate generating the bottom up parser. 50:00 Lecture 8. + +## Terminology 15:00 Lecture 8 + +- A reduction transforms `uwv to uAv` if `A -> w` is a production. +- Right sentenial form. +- Handle (informally: a production than can be used in reverse without getting stuck). + +## The shift reduce process 18:00 Lecture 8 + +This is how bottom up parser work. They have a stack and a table of operations. This can also be represented as a knitting game. + +All bottom up parsers have a similar algorithm: 22:00 Lecture 8 +- A loop with these parts: + - Try to find the leftmost parse tree which has not yet been constructed but all whose children have been constructed. + - This sequence of children is called a handle. + - This sequence of children is built or shifting elements on a stack + - Construct a new parse tree node. + - This is called reducing. + +The only difference in the bottom up algorithms is how they find a handle. +If there is an empty state in the lookup table, we know we have an error. + +How is the parse table built? The table is coded as a DFA (28:00 Lecture 8). + +### LR(0) conflicts + +This algo doesn't always work. A LR(0) conflict is a situation (DFA state) in which there is more than one possible action for the algo. There are two kinds of conflicts: +- Shift-reduce: can't decide between shift or reduce. +- Reduce-reduce: can't decide between two or more reductions for different grammar rules. + +### The shift-reduce problem + +This is when you can either shift or reduce. This is a sign that the grammar is not LR(0). +There are tools that can be used to input a grammar and output what kind of grammar it is. + +## LR(0) vs SLR(1) + +SLR(1) looks at the symbol after the handle (follow set). This means fewer reduce-actoins and therefore removes a lot of potential conflicts. + +## LR(1) + +While SLR just uses the follow set for each production. LR(1) looks at the follow set for each handle. This gives even more reductions. LR(1) parse tables are very big. Expensive but almost all common languages are LR(1). + +## LALR(1) + +A variant of LR(1) that gives smaller parse tables. This is done by combining some states in the parse tree. In practice most practical languages are LALR(1). + +## Parser conflict resolution + +Parsing conflicts are commonly caused by ambiguous grammars. In practice, these ambiguities are solved using a resolution rule however this may or may not do what you want (fx: dangling-else). + +Parsing conflicts must be fixed. You cannot rely on the resolution rule. + + + +# Abstract syntax trees (AST) + +Like a parse tree but with some details omitted. + +Semantic actions and values 5:00 Lecture 9. +Synthesized and inherited attributes. + +AST must be concise and sufficiently flexible. AST is typically constructed bottom up. Lists of siblings are typically generated by recursive rules. + +It should be possible to unparse an AST (reconstruct the source from an AST). + +## Single-pass vs multi-pass compilers + +Single-pass makes a single pass over source text, parsing, analyzing, and generating code all at once. This means that the contextual analyzer and code generator are called from the parser implementation. + +Multi-pass makes several passes over the program. This is the modern approach. The output of a preceeding phase is stored in a data structure and used by subsequent phases. This is more readable and maintainable as the code is more broken down into independant modules. + +## Visitor pattern + +35:00 Lecture 9. + +## Contextual analysis + +Identification and type checking are combined into a depth-first traversal of the AST.
\ No newline at end of file diff --git a/src/_footer.html b/src/_footer.html new file mode 100644 index 0000000..8e0463b --- /dev/null +++ b/src/_footer.html @@ -0,0 +1,2 @@ +<p class="footer"><a href="/">adamski.wtf</a></p> +</html>
\ No newline at end of file diff --git a/src/_header.html b/src/_header.html new file mode 100644 index 0000000..fe44db9 --- /dev/null +++ b/src/_header.html @@ -0,0 +1,10 @@ +<!DOCTYPE html> +<html> +<meta charset="UTF-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> + +<title></title> +<link rel="icon" type="image/png" href="favicon.png"> +<link rel="stylesheet" href="styles/style.css"> + +<p class="header"><a href="/">adamski.wtf</a></p>
\ No newline at end of file diff --git a/src/ase.md b/src/ase.md new file mode 100644 index 0000000..5618803 --- /dev/null +++ b/src/ase.md @@ -0,0 +1,754 @@ +# Q1. Software Process Model - Waterfall +## What is software engineering a response to? +- Increasing system complexity. +- Failure to use software engineering methods. + +There are no universal notations, methods or techniques for software engineering. +This is because different types of software require different approaches. + +There are cases where software projects or software can fail. + +### Increasing system complexity +As new software technology helps us to build bigger, more complicated systems, the requirements change. + +Systems need to be developed and delivered faster meaning more complicated systems are required. +This means more requirements for the systems. + +### Failure to use software engineering methods +It is easy to develop programs without using software engineering techniques... BUT +This can result in more expensive software development and less reliable, readable systems. +To solve this issue, more education and training is required on these techniques. + +## Software engineering process activities +### Software specification +This is where the clients and the developers define the software that should be produced. +This is where the software is limited in terms of what is should be. + +### Software development +This is where the software is designed and programmed. + +### Software validation +This step ensures that the software does what the client requested. + +### Software evolution +When software is modified to meet client's or the market's new requirements. + +## What is a software process model +A software process model is a set or related activities that leads to a software product. +An abstract descriptions of high level software processes. +These can be used to explain different approaches to software development. +These can be interpreted as frameworks that can be expanded and personalized to create more specific software engineering processes. + +### Waterfall model +The model takes the fundamental software process activities. +Seperate process phases: +- Requirement specification +- Software design +- Implementation +- Test + +### Incremental/iterative development +This approach combines the activities with specification, development and validation. +The system is developed in a series of versions (increments) +Each version adds some functionality on top of the previous version. + +### Integration and configuration +This approach depends on the availability of reusable components or systems. +The systemdevelopment process focuses on configuring these components to be used in new contexts and integrate them with the system. +This lets you reuse code from previous projects and save time and money. + +## Waterfall model +Activities are done in a sequence. +Handover of workproducts between phases and milestones are used to monitor progress. +Waterfall model is an example of a plan-driven process. +You are supposed to have all of the process activities and phases planned out before you start development. +The phases in the model directly reflect the fundamental development activities. + +### Requirements analysis and definition +The systems services, limits and goal and made concrete through consulting with the users. +They are then defined in detail and are used as the system specification. + +### System and software design +The overall system architecture is established in this phase. +Identify and describe the fundamental system abstractions and their relations (UML) + +### Implementation and unit testing +The design is implemented in the indivivual program parts. +The design is tested to verify that it meets the specification. + +### Integration and system testing +The individual program parts are integrated and the whole system it tested. +The software is delivered to the client. + +### Operation and maintenance +The system is now installed and in use. +The system is maintained to any issuse that weren't found earlier. +The system is improved over time. + +## When should you consider using waterfall? +For software that needs to be flexible while it is being developed. + +### Embedded systems +The software must interface with hardware. +In this case the hardware is not flexible, thus the software must be. + +### Critical systems +When total security is a requirement of the specification and design. +These systems must have finite specifications and design documents. + +### Large software systems +Part of a larger system being developed by several parties. +This makes finite specifications extremely necessary. + +## How can I decide on waterfall? - analyse home ground +When one phase ends another begins. +Steps come ordered and don't allow for going back and redoing parts. (waterfall flows only down) +When the requirements are mostly unchanging. + +### Plan driven versus agile processes? +Activities in sequence versus all activities at the same time. +Agile development is very flexible and the requirements may be constantly changing. + +## Incremental model +You can iterate within increments and the increments can be planned. +You work within fixed time slots and update the project backlog continuously. +Incremental is an agile process, where you end with multiple versions that you can show the clients as the project progresses. +This allows for the client to come with feedback along the way. + +## Integration and configuration +Development risk is reduced by reuse but there is the risk of not being able to make the desired changes at all or in the time frame. +Most projects have some level of code reuse. +This is often informal. +This reuse requires looking for the existing code, changing them to meet the requirements and integrating them with the new code. + +# Q2. Software Process Model - Incremental/iterative +The incremental development is based on the idea that: +1. Develop in prototypes. +2. Get feedback from the users and others. +3. Develop over multiple versions until the required system is produced. + +Incremental development is the most common approach to developing applications and software. + +## Can it be both plandriven and agile? +Yes, it can be either one or a mix of both. + +### Plan-driven approach +Identify the system increments in advance. +A predictable waterfall plan is split into parts. + +### Agile approach +The early increments are identified. +The later increments depend on progress and the clients priorities. +You work in fixed timeframes and update the full project backlog as you go. + +### Agile-manifest (balance/mix) +Focus on the individuals and teamwork rather than the processes and tools. +Good software comes before comprehensive documentation. +Work with the client instead of using contract work. +Deal with changes instead of sticking to the plan. + +## What are advantages of incremental? + +1. Development costs are reduced +The amount of analysis and documentation that has to be redone is much less than waterfall. + +2. It is easier to get client feedback +The clients can comment on demonstrations of the different versions and see the progress. + +3. Earlier delivery of new software +New features can be made available even if they are not fully completed. + +## What disadvantages are there? + +1. The project is not visible +Managers can have difficulty measuring progress. +It would be a waste of resources to produce documents that reflect the different versions. + +2. The system structure can get messy over time +Changes lead to messy code. +It gets increasingly difficult to add new functions to a system. +Large, complex systems with large teams struggle with incremental for this reason. +Large systems need a stable architecture. +Responsibility of the different teams needs to be clear with respect to this architecture. +This has to be done in advance. + +# Q3. Software Process Model - Integration and configuration +## What are the phases? +### Requirements specification +The inital requirements are suggested +They don't need to be developed in more detail. +They should include short descriptions of important requirements and desired functionality. + +### Software discovery and evaluation +With the overview of the requirements, components are searched for that provide the necessary functionality. + +### Requirements refinement +The requirements are polished with the knowledge of the reusable components that were found. + +### Application system configuration +If an application that meets the requirements is available, it is configured for use in the new system. + +## Advantages/disadvantages +This model reduces the amount of software that must be developed. +This in turn, reduces the costs and risks. + +You usually don't have control of the software that is being reused. +This can include for example how and when new version are released and how the functionality is changed. + +# Q4. Comparison of plandriven and agile including Homeground +## What is the difference between plandriven and agile? +### Plandriven +Plandriven means the desired result can be predicted. +Plandriven = waterfall. +Plandriven is an approach where the development process is planned in detail. +A project plan is created that registers the work that needs to done, who should do it the development plan and the work tools. +Managers use this plan to support project decisions and as a way to measure progress. +This is a traditional approach to software development. + +### Agile +Agile expects changes and frequent user inspection to get the best results. +Agile = Iterative, more detailed Scrum and XP +Agile methods are iterative, the software is developed and delivered in stages. +These versions are not planned in advance but are chosen underway. +Decisions on what should be included in a version depend on the clients priorities. + +## How does Böhm/Turner define primary factors? +### Application +#### Agile +Goal: to handle changes in the project. +Small teams. +Environment is turbulent and fast-paced, project focused. + +#### Plandriven +Goal: predictability, stability and security. +Larger teams and projects. +Environment: stable, few changes, organisation focused. + +### Management (onsite, qualitative control, tacit knowledge) +#### Agile +Customer relations: dedicated clients on site, focused on prioritised changes +Planning and control: qualitative control. Who and how doensn't matter as long as it gets done. +Communications: Tacit knowledge. People do things without needing much explanation or discussion. + +#### Plan-driven +Customer relations: More formal and infrequent. Focused on contract decisions. +Planning and control: Documented plans, quantitative control. It is important to know who does what. +Communications: Explicit. Plans must be discussed and verbalized and shared with the others. + +### Technical +#### Agile +Requirements: can withstand unpredictability. +Development: simple design, small increments, refactoring is assumed to be cheap. +Test: Test cases define the requirements. + +#### Plan-driven +Requirements: Formal project, user interface, quality, predictable requirements. +Development: Comprehensive design, larger intervals, refactoring is costly. +Test: Documented testplans and procedures. + +### People +Cockburn characteristics can describe a programmers personality. +One type may be more favourable than another depending on agile/plan-driven approach. + +## 5 axis on the Home Ground Decision tool +- Criticality: impact of defects +- Personell: average cockburn type +- Dynamism: % requirement change per month +- Culture: % thriving on chaos vs. order +- Size: # of personnel + +## What is continuous integration and how does it relate to agile? +As soon as the work on a task is complete, it is integrated into the whole system. +After such integration, all the unit tests must pass. +Continuous integration uses tools to automate the process. +Depends on unit tests. +Does NOT remove the need for tests. + +## Prototype development + +- Prototype plan: establish objectives +- Outline definition: define functionality +- Executable prototype +- Evaluation report + +# Q5. Key features of SCRUM +Openness of all work. +Respect each other. +Focus on the common goal. +Courage for difficult decisions. +Duty to the common goal. + +3 roles. +5 events. +3 artifacts. + +## Assets +- Scrum board +- Project burndown +- Sprint burndown + +## Three pillars +Transparency: Everyone knows what needs to be done and who is doing what. +Inspect: Keep an eye on where we are heading (daily meetings). +Adapt: Change if it is necessary. + +## Core values +Commitment: to reach the sprint goal. +Focus: on what needs to be done in the sprint. +Openness: Communication is key, don't hide issuse. +Respect: for each other +Courage: to do the right thing + +## Typical errors +Scrum master is a manager. +No communication with the client. +New tasks are added to the sprint backlog in the middle of a sprint. + +## Daily SCRUM +Inspect progress towards the sprint goal. +Adjust the backlog accordingly. +Update (how far are we?) +Short meeting (15 min) +Tell the others if you need help. + +## Sprint planning +Work together with the whole SCRUM team for sprints. +Look in the backlog. +Make a sprint backlog. (this can't be changed from the outside) + +## Sprint review +Check development status. +Sprint review max 4 hours with sprints of 4 weeks. +The client participates along with the team. +Only talk about what has been done. +Dialogue, no presentation. +Update the backlog. + +## Sprint retrospective +For increasing quality and effictivity. +What went well/bad? +How can this be improved for the future? + +## Roles +### Product owner +Stakeholder contact +Updates/prioritises the product backlog +Can be a person dedicated to the client +The goal is the maximise product value +Can delegate but is responsible + +### SCRUM master +Ensure everyone is keeping in-line with SCRUM +Not the management leader +Ensure the team is effective +Deal with the teams blockages + +### Developers +They own the backlog +Programmers, UI, UX and so on + +# Q6. Key features of XP - eXtreme Programming +## What is XP? +An agile, incremental development method with focus on: +- Collaboration +- Quick and early software creation +- Skillfull development practices +XP takes all the 'good things' the extreme. (testing, pair programming). + +The customre should be available full time for the use of the XP team. +In XP, the customer is a member of the dev team and is responsible for bringing requirements. + +Pair programming: developers work in pairs, checking each other's work to ensure quality. + +## Qualities of XP that fit to SCRUM +Pair-programming. +Writing unittests before the code (with the help of TDD). +Partners often have to integrate their code (use continuous integration). +Refactor as often as possible. +Collective ownership of code. +Customer on-site, user stories, planning game, ... + +### What does XP and SCRUM have in common? +Work should be done incrementally/iteratively. +Teamwork, transparency, communication and prioritisation are crucial. +Requirements are broken down into bite-size pieces. +There is overlap with the roles. (XP client and SCRUM's product owner) + +## What values are XP based on according to Larman? +Communication, simplicity, feedback, courage. + +### Communication +Pair programming +Customer on-site +Acceptance test +Daily standup (short meetings) + +### Simplicity +Teams implement exactly what was asked for. Nothing more. +Strive for simple designs and quality code. + +### Feedback +Early and frequent feedback is crucial. +Feedback can come from unittests, team members and the client. +Continuous integration. +Acceptance test that the client performs. +Short sprints. + +### Courage +Developers should be honest. +Don't make excuses for issuse. +Don't be afraid to make big changes. + +## How is XP extreme? +E.g. If tests are good, do them all the time. +Takes all good things, and places them at the core of the process. + +## Name some key practices in XP? +Unit test, pair review, customer on-site, continuous integration, testing, early test, unit test, TDD. + +## What is a user story? +Brief feature request, a promise for conversation. +Written on a card with criteria for confirmation on the back. + +## Story maps - User story mapping +To see the bigger picture of the user stories. +To understand how things are now and to imagine how they could be. +Visualize the stories you tell about your software. + +Story maps consist of: +* User + - a card that tells a story about a type of person, doing something to reach a goal. +* Activities + - Jobs done by similar people to reach a time +* Backbone + - Activies and jobs on a higher goal tier, give the user story structure. + - This is a big goal, that the little goals are attached to. +* User tasks + - Short, concise sentences that explain the goal. +* Sub-tasks + - Break down more complicated goals. +* Release slices + - Identify tasks. The smallest number of tasks that allow specific users to reach their goal. + +Story map process has 4 levels + +## What is the format a user story? +"As a <user> I want <feature> so that <why>". +Who, what, why. + +## How does XP describe Lifecycle for a System? +Exploration, planning, iterations to first release, productionizing, maintenance. + +## What is the iteration called in XP? +Iteration + +# Q7. Product Planning: Requirements Elicitation, Product Vision, Product Roadmap +## What main requirement activities are there? +Elicitation and analysis of needs. +Specification of requirements. +Validation of requirements. + +## Elicitation and analysis of needs +There are two fundamental approaches to Requirement Elicitation: +1. Interview, where people talk about what they are doing. +2. Observation or etnography, where you observe how people do their work and which technologies they use and so on. + +Use a mix of interview and observation to gather information. +This can be used to find the requirements that form the basis of further discussion. + +## Requirement specification +Is a process in which you write down user and system requirements into a document. +Ideally, these requirements should be clear, consistent, complete and easy to understand. +User requirements should be written in natural language and supplemented with dialogue and tables in the document. +System requirements can also be written in natural language, but other notations, graphs, maths, etc can also be used. (state machines, automata) + +## Requirement validation +Is the process of controlling of ensuring that the system requirements will are really what the client wants. +There are different checks that can be used to validate the requirements. + +1. Validity checks: +Check if the requirements reflect the users real needs. +User needs can change over time, so this is an important thing to keep track of. + +2. Consistency checks: +Requirements should not conflict with others. + +3. Completeness checks: +The requirement specification should be comprehensive for every function and the limits that the client wants. + +4. Realism checks: +Using knowledge on existing systems, control the requirements to ensure that they fit within the budget and time-frame. + +5. Verifiability: +You should be able to create tests that verify whether or not a requirement is met. + +## Requirement validation techniques +1. Requirement reviews +Requirements are analyzed systematically by a team of judges, to check for mistakes or conflicts. + +2. Prototyping +Develop executable models of the system and verify with the client that it meets their expectations. + +3. Test-case generation +Tests can be designed along with requirements instead of after the fact. +If it is difficult to design tests for a requirement, that can mean the requirement is unrealistic. + +## What are the steps in elicitation? +1. Discovery & Classification +This is the process of interacting with the stakeholders to find their requirements. + +2. Categorization +Take the unstructured list of requirements and group related requirements together. + +3. Prioritization & Negotiation +Conflicts can arise when there are multiple stakeholders. +Prioritize the most important requirements, through negotiation, discussions, compromises and meetings. + +4. Documentation +Here the requirements are documented. + +## Why is it difficult to elicit requirements? +Many stakeholders with conflicting needs. +Stakeholders speak their own "language". +Lack of communication because things are assumed to be "obvious". + +## What is a recognized way to communicate requirements? +Stories, Scenarios. + +## How are requirements documented in Waterfall and in SCRUM, in Product Planning? +Waterfall: Verify the requirement specificatino with strict change management. +SCRUM: Product vision and product backlog, are discussed and updated every sprint. +Product Planning: Product vision, release plans and/or product roadmaps. +XP: User Stories. + +## How are requirements negotiated with stakeholders in Waterfall and SCRUM? +Waterfall: Be up front in the requirements phase - state it now or it will be difficult later on. +SCRUM: Ongoing refinement of product backlog with stakeholders, say what is most important now, we will continue. +XP: Customer on-site. + +# Q8. Product Refinement and Forecasting: User story mapping, personas, stakeholders, product backlog +## What is a persona? +User personas are a useful technique to describe users of your product. +A fictional character with a name, picture, relevant characteristics, behavior, opinions and a goal. +Different people can have different goals. +Understand a personas goal is useful for creating a product that is meaningful to the users. + +## What is a user story? +Short description on a type of user, a goal and a reason. + +## Where do we use the terms: Product Feature, Epic, User story? +Product Feature: Corresponds to an Epic. +Epic: A collection of related user stories. +User story: Breakdown of an Epic. + +## What is a user journey? +The experiences a person has, when interacting with the software. + +## What are the key characteristics of a product backlog? +This is to do list of items a SCRUM team must tackle. +- Software requirements. +- User stories. +- Descriptions of supplementary tasks that are needed, such as architecture definition or user documentation. + +# Q9. Risk Management +A risk is a potential problem. +The possibility of loss or damage. +Risk Management: project leaders must evaluate the risks that can affect a project, monitor them, and handle them when problems arrise. + +## Example of risk categories +1. Uncertainty, project, technical, business. +2. Keyperson from team dies, a supplier is not delivering as promissed. + +## Categories of risk +### Project risks +Risks that threaten the project plan. +Time will be wasted and costs will rise. + +### Technical risks +Architectural design. +Arrises because problems can be harder to solve than expected. +Vagueness in the specification. +Project gets older and starts to decay. + +### Business risks +Market risk. What if no one uses the product? +Strategic risk. We don't need that new component after all. +Sales risk. How the fuck do we sell this?! +Management risk. The top management don't support the project anymore. +Budget risks. Budget or personnel is lost. + +## How do you do risk analysis? +Risk analysis and management are actions, that help a software team understand and handle uncertainty. +It is a good idea to identify risks. +Evaluate the probability of risks. +Estimate the impact of a risk and form a reaction plan for if the risk actually happens. + +## Identify risks and calculate risk exposure and describe consequence. +Risk exposure = probability * loss, describe consequence. +Probability < 100%. If p = 100% then it's an issue. + +Prioritize according to risk exposure, establish cut-line. +Deal with the risks above the line, accept the ones below. + +Establish for each risk above the cut-line (RMMM: Risk Mitigation, monitor, management) +### Mitigate +We want to prevent the risk from becoming an issue. +We can reduce the probability. +Or try to reduce the associated loss. +Risk exposure = probability * loss. + +### Manage +For when a risk has become a loss, try to minimize the loss. +This assumes the mitigation activity was unsuccessful. +This is done by the project leader. + +### Monitor +Observe how risks change over time. +How the probabilities, loss, or the environment, change over time. + +## How are risk management part of project management +### Waterfall / plan-driven +Risk and risk plans are part of the plans in project management. +Development of others plans to contribute to identification of risk. +It is planned. + +### Agile - inspect and adapt is reduction to produce the right product +Daily SCRUM: Do you have any impediments? +Sprint review: Inspects risk related to product and stakeholder. +Sprint retrospective: Adresses risks related to how the team works. + +## What are Böhms primary risks? +Personal shortcomings, unrealistic schedule, wrong function... + +# Q10. How is quality defined? +## Software quality attributes +### Nonfunctional requirements +Safety, security, reliability, complexity, adaptability, testability, understandability, efficiency, usability, etc... + +### Functional requirements +- Requirement Specification (waterfall) +- Product backlog and User Stories (agile) + +## What is quality? +Quality is evaluated aesthetically, symbolically and functionally +Quality can be either objective or subjective. +Quality may not always be obvious. + +## Definition of quality +Quality is a reflection of one or more peoples evaluation of the compliance of a product or service with their expectations. +Quality can be broken into three types of categories: +1. Product quality. +2. Process quality. +3. Quality of expectations. + +Quality tradeoffs are unavoidable. +Quality consists of: +- Quality assurance: plan or design processes to prevent bad quality. +- Quality control: track that work products meet quality standards. + +## Why invest or pay for Quality Management? +Cost of not doing it is bad quality - fixing errors. + +Direct cost of error correction: +- Loss. (effort) +- Wasted work. (for users of the program) +- Maintenance usually has larger costs than development. + +Indirect cost of error correction +- Follows from poor quality (unsatisfied users) +- Has potentially severe consequences (losing customers) + +Quality Management reduces these costs significantly. + +## Validation (fit for use) +Are we building a system that is fit for use? +Compliance with the users expectations and experiences? + +## Verification (requirement specification being met) +Do we pass all tests and requirements? +Are we building a system with all the requirements implemented? +Unit/integration tests + +## Techniques for verification and validation +Testing: of programmes and prototypes. +Review: of specifications, documentation and programs. + +## Is it verification or validation? +A user must participate in order to validate. +Verification focuses on the compliance to the specifications and a client usually doensn't participate. + +## V-model + +# Q11. Test and review +Tests are a set of practices that support verification and validation. +The purpose is to ensure a program does what it is supposed to, and to discover errors before delivery. +This is done by making sure the progrm meets the requirements and by finding incorrect or undesirable behaviour. +Verification: Unit test, component test. +Validation: prototype test, user acceptance test. + +## What is peer review? +Evaluation of work of one or more people with similar skills (peers). +Mostly in the form of documents but can also be analysis of code. + +## What is the difference between review and test? +Review is static, and there is no interaction between errors found in review. +Tests are dynamic and errors can come as side-affects of an initial errors. +Reviews (inspections) and tests are complementary to quality techniques. +Both should be used under the verification and validation process. +Inspections can control compliance with a specifications but not with the clients or users actual requirements. +(Unless the user participates in the review. Prototypes are preferred for user participation) +Inspecions cannot control non-functional properties such as performance, usability, etc. + +## When is review good? +For documents, designs, architectures, plans, etc. + +## When is test good? +For functionality and dynamic use of the program. + +## What is the V-Model +A model that shows the connection between tests at different levels and primary activities that drive the tests. + +## Name tests at different levels: +Unit test, component test, integration test, system test, user acceptance test. + +Unit test: confirm valid and invalid input. +Integration test: confirm that interfaces are compatible and work as expected. +Acceptance test: validate fit for use, exploratory test. + +## When is test done? +Plan driven: in the end (often a dedicated test-team aspart of QA) +Agile: all the time (test competence on the team, accept criteria on story, automated test, TDD) + +# Q12. Configuration Management and DevOps +## What is DevOps, how can you define it? +DevOps is a method for both development and operation. +DevOps is a development method for IT systems that connects different activities in projects. +DevOps is a culture, that focuses on the entire software productions life cycle. +The goal is to remove barriers between development and operation teams, to be able to react quickly to the users needs. +It is also defined by The Three Ways: +1. Flow. +2. Feedback. +3. Continuous Learning. + +## What is the purpose of Continuous Integration? +When the code is checked, it is automatically integrated with the system. +Speed up the rate of delivery and run tests constantly. +Bsed on tools to automate the process. +Depends on a suite of unit tests. +Does NOT eliminate the need for testers. + +## What is the purpose of Continuous Testing? +Continuous Testing in DevOps is a type of software test that involves testing at all stages of a develoments lifecycle. +The goal is the continuously evaluate the quality of the software. + +## What is the purpose of Continuous Delivery and Deployment? +### Continuous Delivery +Ensure that code can be implemented securely. +Ensure that the business and service application function as expected and deliver every change to production. + +### Continous Deployment +Ensure that tests are automated and that every change is automatically implemented in production. +Makes the development and release process faster and more robust. + +Automated access to well defined environments. +Tools like Docker for containerization or Virtual Machines. diff --git a/src/game.md b/src/game.md new file mode 100644 index 0000000..f9bae8e --- /dev/null +++ b/src/game.md @@ -0,0 +1,22 @@ +<p class="note">May 7, 2021</p> + +# My game + + +Aftershock (working title) is a multiplayer old-school arena shooter being made in Unity. It's a hobby project that I have been working on since 2016. It started as a *warmup* project before jumping into developing an MMO, but I have since learned how much work goes into making just a multiplayer fps. Especially as a solo project. + +At it's core, Aftershock is supposed to be my attempt at recreating a mix of Quake 3 / Quake Live along with whatever else I decide to add. + +Main features (so far): + +- p2p multiplayer +- support for custom maps +- vq3-like movement +- rocket launcher + rocket jumping +- health pickups +- 3 gamemodes (FFA, TDM, Race) + +I'm in the process of rewriting a lot of systems in the game at the moment because I'm switching from janky p2p multiplayer to an authoritative server setup with client-side prediction. [more](https://www.gabrielgambetta.com/client-server-game-architecture.html) + +[Gameplay clips](https://www.youtube.com/c/rizen1) +[Follow my progress](https://trello.com/b/ycQyrouQ)
\ No newline at end of file diff --git a/src/index.md b/src/index.md new file mode 100644 index 0000000..d59e444 --- /dev/null +++ b/src/index.md @@ -0,0 +1,14 @@ +Hello there! + +My name is Adam and I am a computer nerd studying at Aalborg University. I am interested in space, game dev, sailing and the outdoors. + +I'm currently working as a student developer at E-Komplet and I work on my multiplayer old-school arena shooter in my free time. I occasionally post videos of my game along with other stuff [here](https://youtube.com/c/rizen1). + +## Posts +[Project Aftershock // Rizen's Arena](game.html) + +## Links +[Github](https://github.com/adamstuck) +[Youtube](https://youtube.com/c/rizen1) +[Steam](https://steamcommunity.com/id/rizen1/) +[Twitch](https://www.twitch.tv/rizen1337) diff --git a/src/styles/style.css b/src/styles/style.css new file mode 100644 index 0000000..557c0ca --- /dev/null +++ b/src/styles/style.css @@ -0,0 +1,91 @@ +html { + background-color: #181a1b; + margin: 1em auto; + max-width: 52em; +} +body { + color: #ddd; + font: 1.0em/1.5 'Open Sans', sans-serif; + -webkit-text-size-adjust: 100%; + scrollbar-color: #454a4d #202324; + margin-top: 0; +} + + +h1 { + margin-top: 2.5em; + font-size: 2em; +} + + +a { + text-decoration-thickness: 1px; + text-underline-offset: 5px; +} +a, a:link, a:visited { + color: #fda; + text-decoration-color: #ca8; +} + + +pre, code { + font: 1.1em/1.5 monospace; +} +pre { + overflow-x: auto; + padding: .5em 1em; + background-color: #222; +} +code { + white-space: pre; + color: rgb(251, 252, 189); +} +pre code { + color: #ddd; +} + + +p img, table { + max-width: 100%; +} +img { + display: block; + margin-left: auto; + margin-right: auto; +} + + +blockquote { + background-color: #222; + border-left: 5px solid #e6c79a; + margin: 0em 1em; + padding-left: 1em; +} + + +.header { + font-size: 2em; + margin-top: 1.5em; + margin-bottom: 1em; +} +.footer { + margin-top: 2em; +} +.note { + margin: 0; +} +.header, .footer, .note, .note a { + color: #888; +} +.header a, .footer a { + color: rgb(198, 90, 90); + text-decoration-color: #555; +} + + +/* .button { + display: inline-block; + border-color: #fda; + padding: 0.5em 1em; + text-decoration: none; +} */
\ No newline at end of file |