Drasil
Drasil copied to clipboard
SWHS Body, Hardcoded Names
Better names should be used for some things in SWHS Body


Here is a summary of what we discussed today (June 17th, 2022).
The problem is variable names, phySyst1
, phySys2
, did not capture enough knowledge, and they will decrease the readability.
The reason is that we don't have a clear structured knowledge of some SRS.
For example, if phySyst1
and phySys2
are sentences in a paragraph, they have a different meanings. The first sentence usually is a topic sentence. Then, there will be the background, argument, summary, and so on. In structured writing, there is a lot of meta knowledge. That's the missing part.
Thank you for the comments @cd155. Well said. We also discussed adding a link to this issue to the contributor's guidelines, so that future contributors watch for this kind of error.