csharp
csharp copied to clipboard
cleanup about.md files
Through a largely mechanical process the original after.md document for each of the C# exercises has been split into about.md/links.json files. Each component concept of the exercise is allocated a separate about.md file.
The concept files need to be reviewed:
- TODOs need to be actioned
- A couple of "general reference" sections containing links may need to be removed (links.json takes their place)
- Some text needs to be transferred to "approaches"
- Some closely coupled concepts need to be teased apart (e.g. arrays, for-loops, foreach)
- Exercise files need to be changed or new exercises need to be added where concepts appear to be introduced in an unconventional context (e.g. bitwise operations introduced in flag-enums)
- We need to find a way to compensate for the fact that concepts are no longer so closely associated with exercises. One of the particular advantages of the Exercism approach is that learning is structured round a framework of practical exercises - we should ensure we don't lose that in the case of concepts.
Ensure that the matching links.json file is kept up-to-date.
I think that seeing how the concepts look as part of the user experience (which we should be able to do shortly with the beta) should help guide the final format of concepts.
The following concepts are affected:
- accessibility
- arithmetic-overflow
- arrays
- attributes
- basics
- bit-manipulation
- booleans
- casting
- chars
- classes
- compound-assignment
- conditionals-ternary
- const-readonly
- constants
- constructors
- datetime
- datetimes
- defensive-copying
- dictionaries
- do-while-loops
- enums
- equality
- exception-filtering
- exceptions
- explicit-casts
- expression-bodied-members
- flag-enums
- floating-point-numbers
- for-loops
- foreach-loops
- generic-types
- if-statements
- indexers
- inheritance
- integral-numbers
- interfaces
- lists
- memory-allocation
- method-overloading
- mm1.txt
- named-arguments
- namespaces
- nested-types
- nullability
- numbers
- object-initializers
- operator-overloading
- optional-parameters
- ordering
- overflow
- parameters
- pattern-matching-constants
- properties
- randomness
- readonly-collections
- regular-expressions
- resource-cleanup
- resource-lifetime
- sets
- string-builder
- string-formatting
- string-interpolation
- strings
- structs
- switch-expressions
- switch-statements
- throw-expressions
- time
- timezone
- tuples
- user-defined-exceptions
- varargs
- verbatim-strings
- while-loops
I have raised the question of Exercise files need to be changed or new exercises need to be added where concepts appear to be introduced in an unconventional context (e.g. bitwise operations introduced in flag-enums) at here
I think that flag-enums
/ attack-of-the-trolls
is the only exercise that falls into this category.