| Safe Haskell | None |
|---|---|
| Language | GHC2024 |
Drasil.SRS.Sections.Introduction
Description
Defines functions used in creating an introduction section.
Synopsis
- orgSec :: NamedIdea c => c -> Section -> Maybe Sentence -> Section
- introductionSection :: Sentence -> SmithEtAlSRS -> [Sentence] -> [IntroSub] -> [Section] -> Section
- purposeOfDoc :: SmithEtAlSRS -> PurposeDescription -> Section
- scopeOfRequirements :: Sentence -> Section
- charIntRdrF :: ProjectName -> [Sentence] -> [Sentence] -> [Sentence] -> Section -> Section
Documentation
introductionSection :: Sentence -> SmithEtAlSRS -> [Sentence] -> [IntroSub] -> [Section] -> Section Source #
Constructor for the Introduction section. In order, the parameters are:
- problemIntroduction -
Sentenceintroducing the specific example problem. - programDefinition -
SmithEtAlSRSdefinition of the specific example. - extraInfo - List of extra
Sentences to include in the overview paragraph. - introSubs - List of IntroSub describing what subsections exist.
- subSections - List of subsections for this section.
purposeOfDoc :: SmithEtAlSRS -> PurposeDescription -> Section Source #
Constructor for Purpose of Document subsection. Takes a list of Sentences that:
- Given one element: explains the purpose of the specific example.
- Given two elements: explains the purpose of the specific example and the development process.
- Otherwise: Uses the default
developmentProcessParagraph.
scopeOfRequirements :: Sentence -> Section Source #
Constructor for the Scope of Requirements subsection. Takes in the main requirement for the program.
charIntRdrF :: ProjectName -> [Sentence] -> [Sentence] -> [Sentence] -> Section -> Section Source #
Constructor for characteristics of the intended reader subsection. Takes
the program name (ProjectName), assumed knowledge (Sentences),
topic-related subjects (Sentences), knowledge assets (Sentences), and
references (Section).