A variety of changes were made to the documentation of the schema’s definitions. Some rewording might have been inadvertently done, during the process of copying and pasting, however more intentional changes were made in order to make the structure of the schema more evident (Granted these changes were all made in the template file, so I do not believe a direct adaptation to the schema is possible.). The chief decision regarding documentation was to condense all necessary information to create a draft of the schema into a single document (template file). By structuring the documentation in a more consistent style, I believe I was able to make it more clear to a reader what was being asked of them in each section, and was caused by my initial displeasure with parsing together how to approach the schema by looking directly at schema documentation, in addition to referencing the template document. Other small changes like correcting minor errors (e.g. the ‘cost’ page not appearing on the template, some incomplete definitions), or fleshing out points to make them more clear were also made.
The proposed changes to the schema are as follows :
prelim_ana – I felt the goals of this section were obscure with respect to those found in the ’sccs_crt’ section. To try and better communicate the nuanced differences, I renamed the attribute to ‘prelim_ana’ from ‘prelim_req_ana’. It was not clear to me what ‘req’ was referring to. I also added important definitional specifications that highlight the differences between these two attributes.
exec_sum – For the exec_sum page, I would add the following tags that must be written in order : background, report_purpose, approach, key_findings. These (along with their informational definitions) provide the writer with a better idea of what a representation of an executive summary should look like. This was inspired by the fact I had no experience with executive summaries, and when referencing the individual writings of group 2 and correlating them with what I found online, I found an undefined range of expositional tone setting to concisely informational.
fsb – I changed the <fsb_hlgt> element’s ‘suits’ attribute type name to ‘lgl’. Not only do I believe that this name has a more obvious meaning to it, but it also matches the naming of the legal type attribute for the ‘cost’ page.
sscs_crt – I added four attribute types for the <req_sect> element. These were, ‘technl’, ‘tmfrm’, ‘socl’, ‘other’. I believe these attribute types lend a better understanding to the concrete demands that are being put forth, helping to distinguish its purpose from ‘prelim_ana’.
fnc : I removed the ‘exp’ type attribute from this section. It seems there is redundancy here with respect to this page and the ‘cost’ page.
conc : I removed the ‘sum’ tag. It seems to me that the conclusion section is better situated as being entirely a summary section, rather than a set of sentences toward the end of the section. This was also informed by examples I found online.
Three last structural notes, it seems that it would make more sense in the genre if only one of each page type were allowed per page; secondly, the ’n’ tag specified in sections other than ’tbl_contents’ don’t seem to have much importance, and I believe can be removed without jeopardizing the genre model; thirdly, I found the enforced ordering of the pages to seem somewhat arbitrary. It seems the fastest way to be informed on the correct order by generating errors by placing pages in the incorrect order. Although changes could be made so that the schema more directly represents the genre, I do not believe that either change would greatly have changed my writing process.